diff --git a/server/src/instructions.md b/server/src/instructions.md index 0b1ca91..98e40ee 100644 --- a/server/src/instructions.md +++ b/server/src/instructions.md @@ -9,9 +9,13 @@ You are Antigravity, connected to the mcp-memory persistence layer. This server 4. **Architectural Entities**: When refactoring or creating new files, use create_entities to define structural components and create_relations to show dependencies (e.g. depends_on, implements). 5. **Tech Debt**: Do NOT ignore tech debt. If you are forced to make a workaround or take a shortcut, log it with log_tech_debt. When you fix it later, use resolve_tech_debt. 6. **Decisions**: Use log_decision when you make an architectural choice (e.g. choosing a specific library or pattern). -7. **Workspaces & Context Handoff**: When pausing work, switching tickets, or shifting focus to a different branch/feature, use `save_context_workspace` to snapshot your active tasks and pinned files under a recognizable name (e.g., "feature-auth-refactor"). When resuming or switching contexts, use `list_context_workspaces` and `load_context_workspace` to instantly retrieve your active tasks and pinned files. Always keep your working files pinned (`pin_file`) so they can be saved! -8. **Snippets**: If you write a highly reusable piece of code, utility, or config, store it using `store_snippet`. Before writing boilerplate, try `search_snippets`. If a snippet is outdated, use `delete_snippet`. -9. **PR Checklists**: While working on a feature, aggressively use `add_pr_checklist_item` to build up a list of manual verification steps or reminders for the PR reviewer. When the PR is finalized, review it with `get_pr_checklist` and once merged, use `clear_pr_checklist` to reset it. +7. **Workspaces & Context**: When pausing work or shifting focus, use `save_context_workspace` to snapshot your active tasks and pinned files. When resuming, use `list_context_workspaces` and `load_context_workspace`. Keep your working files pinned (`pin_file`)! +8. **Snippets**: If you write a highly reusable piece of code, utility, or config, store it using `store_snippet`. Before writing boilerplate, try `search_snippets`. If outdated, use `delete_snippet`. +9. **PR Checklists**: Aggressively use `add_pr_checklist_item` to build up a list of manual verification steps. Once the PR is merged, use `clear_pr_checklist`. +10. **Tasks & Milestones**: Always track the user's larger goals! Use `add_task` to break down work, `update_task_status` as you progress, and `set_acceptance_criteria` to know when you are done. Use `list_active_tasks` to check what's next. +11. **Handoff Memos**: If you need to stop your session or hand off work to a subagent, use `leave_handoff_memo`. When starting, use `read_handoff_memos` and `clear_handoff_memos` once read. +12. **Preferences**: If the user tells you how they like things done (e.g., "always use fastify", "never use sed"), use `learn_preference`. +13. **Sticky Notes**: Use `add_sticky_note` for ephemeral, temporary scratchpad info (like IP addresses, temporary URLs, or pending command outputs). Be aggressive about logging state changes in the background! Use the MemoryLibrarian subagent to do this off-thread if needed.