AGENTS.md · git:20261003.ed77b30 · 2026-10-03 · sha256 fcf3050ae51b7343

AGENTS.md git:20261003.ed77b30A

Immutable. This exact content never changes and is served at /api/v1/blob/fcf3050ae51b7343.

# AGENTS.md

Instructions for coding agents (Codex, Claude) working in this repository.

- What to build: `docs/specs/2026-09-24-wuwei-design.md`. How to build it:
  `.specify/memory/constitution.md`. Read both before starting.
- Work follows spec-kit in strict mode (constitution, Workflow): `speckit-specify`,
  `speckit-clarify`, `speckit-plan`, `speckit-tasks`, `speckit-analyze` (save the report
  as `analysis.md`; resolve CRITICAL and HIGH findings), `speckit-checklist`, then
  `speckit-implement` (skills in `.agents/skills/`). One GitHub issue is one feature,
  created with `.specify/scripts/bash/create-new-feature.sh --json --number <issue>
  --short-name <slug> "<description>"`. Do not ask clarifying questions; answer them with
  your recommendation, record assumptions in the spec under Assumptions and move on.
- Test first. Write the failing test, run it, see it fail, then implement.
- Runtime code is stdlib-only Python 3.11+. pytest is dev-only. Run tests with
  `python -m pytest -q` from the repository root using the interpreter your task names.
- Keep it simple: reuse what exists, no speculative abstractions, shortest working diff.
- No emojis and no em-dashes in anything you write.
- Do not run `git commit`, `git push` or any `gh` command. Leave changes in the working tree.