Core docs
docs/agentic/contributor-workflow.md - canonical contributor-friendly, agent-compatible workflow contract
docs/agentic/codex.md - Codex-specific MCP, skill, and protected-worktree notes
docs/agentic/definition-of-done.md - canonical closeout checklist for non-trivial feature work
docs/agentic/definition-of-ready.md - canonical readiness checklist for non-trivial feature work
docs/agentic/feature-design-loop.md - repeatable product/UX/infrastructure/cost/security planning loop for large features
docs/agentic/parallel-worktree-delivery.md - candidate local fanout/converge workflow for parallel agents and worktrees before one integrated PR
docs/agentic/product-analytics-and-feature-flags.md - canonical first-pass rollout, flagging, and product instrumentation policy
docs/agentic/software-factory.md - repo-specific software-factory posture, review/recycle loops, supervisor/resume policy, task-pool direction, mergeability recovery, and LLM/agent observability boundaries
Working rule
- put durable workflow and orchestration concepts here
- keep
AGENTS.md short and durable
- keep onboarding-heavy material in a skill or doc, not in every-session prompt text