Skip to content

AGENTS.md

Latest commit

 

History

History
47 lines (35 loc) · 2.12 KB

AGENTS.md

File metadata and controls

47 lines (35 loc) · 2.12 KB
Raw

GraphReFly Stack — agent index

This file points; it does not host project truth. Canonical records are JSONL under docs/.

Stack decision identity is graphrefly-stack:<D#>. Language-neutral protocol and cross-project responsibility boundaries remain in the graphrefly owner ledgers resolved through ~/src/graphrefly/authority/ledgers.jsonl; new cross-repo refs must be origin-qualified.

Read first

  1. docs/sources.jsonl — authority map: one canonical file per concern
  2. docs/decisions/decisions.jsonl — locked decisions and rationale
  3. docs/plan/phases.jsonl — the single canonical sequencer and current next phase
  4. The concern-specific sources referenced by those records

Do not duplicate canonical facts in this file, skills, README prose, or implementation plans. Update the owning JSONL record and keep references pointing to it.

Personal project governance

Before decision or work admission, design review, dispatch, QA, long-running goal progression, live/provider/spend authorization, retry, or stalled-work recovery, load and follow the personal $project-governance skill at ~/.codex/skills/project-governance/SKILL.md. This adopts a cross-project classification and manual-authorization floor only; Stack retains its independent product authority, IDs, ledgers and gates. Use a qualified GraphReFly family contract only for an actual cross-project boundary, never as Stack product authority.

Workflow routing

  • Long-lived product sequencer: .agents/skills/stack-goal-dispatch/SKILL.md (D47)
  • Decision or scope question: .agents/skills/stack-decision-guard/SKILL.md
  • Scenario, contract, architecture, or UI review: .agents/skills/stack-design-review/SKILL.md
  • Implementation from the canonical sequencer: .agents/skills/stack-dev-dispatch/SKILL.md
  • Code, evidence, security, privacy, and product-readiness review: .agents/skills/stack-qa/SKILL.md (D13)

Commands

mise run bootstrap
pnpm check
pnpm docs:check
npm --prefix ~/src/graphrefly run authority:check:workspace
pnpm lint
pnpm format

New Stack decisions after D60 must satisfy ~/src/graphrefly/authority/README.md.