# Ticket: Audit and overhaul AGENTS.md startup router

## Metadata
- Type: Ticket
- Status: Done
- Project: Nimrod / Agent Operations
- Created: 2026-06-06
- Updated: 2026-06-06
- Priority: High

## Goal

Audit and overhaul `AGENTS.md` so it becomes a lightweight fresh-context entrypoint for Nimrod rather than a bloated operations manual.

## Why

Nimrod must handle many roles and request types while keeping fresh context light. Detailed memory, procedures, handovers, infrastructure facts, and role architecture should live in linked markdown docs and indexes.

## Scope

Included:
- Preserve stable mission/safety/workflow rules
- Make `AGENTS.md` a progressive-disclosure router
- Point to linked markdown docs for memory, handover, QRSPI, DevOps, roles, systems, SSH, and tickets
- Remove long command blocks and overly specific operational details from startup context

Not included:
- Rewriting all linked docs
- Resolving all current dirty files
- Migrating service-specific content to separate repos

## Acceptance Criteria

This ticket is done when:
- [x] `AGENTS.md` is concise and router-oriented
- [x] Personal-assistant-first mission is clear
- [x] Linked markdown memory/retrieval approach is clear
- [x] Fresh-context routing is clear
- [x] Safety and verification rules are preserved
- [x] Detailed procedures are delegated to linked docs

## Notes

- A reviewer and structurer subagent audited the current `AGENTS.md` before rewrite.