git:20261007.8cdc916 to git:20261018.54f438e

1 added, 1 removed. Audit A to A.

# 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).

## Project notes

Write project-specific commands, files tasks must leave unchanged, and slow or

expensive operations after the `CAFEKIT CORE END` marker. Everything between the

CafeKit markers is replaced on every install.

## Language Consistency

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.

## 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.

+ - `.claude/`, `.codex/`, `.agents/` are git-ignored install output of `packages/spec/src/`, replaced on every reinstall. Change skills, rules, agents, hooks, and output styles in `packages/spec/src/`, then reinstall; an edit made only in the installed copy is lost.

- `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.