AGENTS.md · diff
git:20260923.e083bd9 to git:20261006.fe53100
13 added, 0 removed. Audit A to A.
<!-- CAFEKIT CORE START -->
# AGENTS.md
## Shared CafeKit instructions
- Deliver exactly what was asked. Do not expand, polish, or add optional work beyond the request. Match existing code style and structure.
- For process-first Specs, `plan.md` and flat `task-NN-*.md` files are
canonical, hand-editable state. Each task has exactly one `Status:` field and
keeps canonical execution proof in its final inline `## Receipt`.
- Specs uses three user decisions: GATE-SCOPE for scope, GATE-REVIEW for adversarial findings,
and GATE-DONE for completion. Planning never starts implementation; implementation
requires a new explicit user invocation.
- Synchronize only observed task state with surgical edits. Never invent proof,
readiness, approval, review independence, or completed work.
- `NO_TESTS` and `0 tests + exit 0` do not pass when the task requires automated tests.
- When a hook blocks an action, that is an instruction boundary — do not work around it.
- Use conventional commits. Do not add AI attribution unless requested.
## Response style
Keep replies focused and brief. Match written-file length to task needs. Do not add filler sections or redundant summaries. Lead with the outcome.
## Uncertainty
Say when you are unsure and what would settle it. Label inferences instead of presenting them as verified facts.
## Delegation
Do the work yourself when it takes a handful of tool calls. Delegate genuinely independent parallel tracks. Verification comes from the project's hooks and validators, not from spawning more agents.
## Runtime ownership
- This `CORE` block is runtime-neutral and safe for every runtime.
- Runtime-specific instructions live in that runtime's own managed block, not in `CORE`.
- In a combined install, consume `CORE` plus your native block only. Ignore managed blocks not owned by your runtime. If ownership is unclear, treat the file as `CORE`-only (fail-safe).
## Commands
<!-- Add project-specific install, test, lint, and build commands here. Keep commands executable. -->
## Do not touch
<!-- List files, directories, generated artifacts, or secrets that tasks must leave unchanged. -->
## Slow or expensive
<!-- Note commands, environments, or operations that need explicit planning before running. -->
## Language Consistency <!-- cafekit:lang -->
Always respond in **Tiếng Việt**. Technical terms, code identifiers, and file paths may remain in English, but explanations, comments directed at the user, and structured output must be in Tiếng Việt.
<!-- CAFEKIT CORE END -->
+ ## This repository
+
+ ### Commands
+ - Self-tests: `pnpm --dir packages/spec test`
+ - Node tests: `node --test packages/spec/bin/__tests__/*.test.js packages/spec/src/claude/hooks/__tests__/*.test.js`
+
+ ### Do not touch
+ - `.claude/` is install output of `packages/spec/src/claude/`; edit the source.
+ - `evals/results/` holds paid run artifacts (git-ignored); do not delete them.
+
+ ### Slow or expensive
+ - `evals/run.sh <skill> …` runs paid model evaluations; plan the run count and budget first. `evals/run.sh <skill> --validate` costs nothing.
+