diff --git a/AGENTS.md b/AGENTS.md index 4daa850..94ffba5 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -5,6 +5,7 @@ - **Parallelise with subagents:** For every task, use multiple subagents with the appropriate model to work more efficiently. Dispatch independent subtasks in parallel rather than executing them sequentially. - **Subagent model selection (MANDATORY):** You MUST use the right model tier for each subagent — `claude-haiku-4.5` for fast/simple/mechanical tasks, `claude-sonnet-4.6` for default/standard implementation work, and `claude-opus-4.6` for complex reasoning or architecture decisions. Never use the same model for all subagents. - **Minimize main agent context:** Always delegate tasks to subagents with the right model to execute each task more efficiently and keep the main agent context window usage minimum. The main agent should coordinate and synthesize, not perform detailed implementation work. +- **Project maturity + risk posture:** Flynn is a local, work-in-progress project and is not in production. Breaking code is acceptable when necessary, but every change must include the right tests to validate expected behavior. - **Commit often:** `git commit` frequently — after each meaningful unit of work, not just at the end of a task. - **Commit structure:** Prefer small, atomic commits that each represent one meaningful unit of work. Keep unrelated changes out of the same commit. When a change affects docs/diagrams/state, update and commit those alongside the code change (not later). - **Branch + merge workflow:** Do work on a feature branch (`git switch -c feature/`). Keep branches rebased onto `main` (avoid merge commits). When finished: `git rebase main`, then fast-forward merge back to main: `git switch main && git merge --ff-only feature/`, then delete the merged feature branch: `git branch -d feature/`.