1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
|
# Agent Configuration & Master Rulebook (.agent/config.md)
This is the primary source of truth for all AI agents working on **Nav**. These instructions take absolute precedence over general defaults.
## 1. Project Directory Structure (.agent/)
| File | Purpose |
|------|---------|
| `config.md` | **Main Entry Point** — Rules, workflows, and core mandates. |
| `worklog.md` | **Session State** — Current focus, recently completed, and next steps. |
| `design.md` | **Architecture** — Component design, UI mockups, and roadmap. |
| `coding_standards.md` | **Technical Standards** — Android/Kotlin best practices, offline-first. |
| `mission.md` | **Mission & Values** — Strategic goals and agent personality. |
| `narrative.md` | **Background** — Historical context and evolution of the project. |
| `preferences.md` | **User Prefs** — Living record of user-specific likes/dislikes. |
## 2. Core Mandates
### ULTRA-STRICT ROOT SAFETY PROTOCOL
1. **Inquiry-Only Default:** Treat every message as research/analysis unless it is an explicit, imperative command (Directive).
2. **Zero Unsolicited Implementation:** Never modify files, directories, or processes based on assumptions.
3. **Interactive Strategy Checkpoint:** Research first, present a strategy, and **WAIT** for an explicit "GO" before any system-changing tool call.
4. **No Destructive Assumptions:** Always verify state (`ps`, `ls`, `git status`) before proposing actions.
5. **Root-Awareness:** Prioritize system integrity and user confirmation over proactiveness.
### Living Documentation Mandate
1. **Continuous Capture:** Agents MUST proactively update the files in ".agent/" as new decisions, patterns, or user preferences are revealed.
2. **No Stale Instructions:** If a workflow or technical standard evolves, the agent is responsible for reflecting that change in the Master Rulebook immediately.
3. **Worklog Integrity:** The ".agent/worklog.md" must be updated at the start and end of EVERY session.
|
