Skip to main content

Agentic Docs

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