Catch-up prompt
Paste into an agent session at the root of an existing repo.
Bring this repo in line with the project-knowledge rules at https://mojzis.github.io/clauding/rules/v1/ (rationale: https://mojzis.github.io/clauding/llms.txt).
- Read the rules. Check
AGENTS.md/CLAUDE.mdfor aproject-knowledge rules vNmarker. - No marker: full adoption (steps 2โ8). - Older version: apply only what changed between versions, then bump the marker. - Add the rules section to
AGENTS.md. IfCLAUDE.mdexists, have it referenceAGENTS.mdrather than duplicate it. - Copy the scaffold:
QA.md,docs/style.md,docs/tags.md,docs/adr/,docs/papercuts/. Readdocs/style.mdnow. It governs everything you write below. QA.md(one per subproject in a monorepo): - Find the commands in CI config,pyproject.toml, Makefile/justfile. CI is the reference. - Run every tier you can. Fillexpectonly from what you observed. Never write an expectation you didn't see. - A tier that fails or can't run now becomes a papercut. Don't fix it in this pass. - Propose oracles from the code and data: invariants, bounds, candidate reference cases. All go in asstatus: proposed. List them in the report for a human to confirm.docs/architecture.md: if missing, write it from the code as it is today. This is the baseline. Describe only what you can verify in the code and don't guess at intent. Do not write ADRs for past decisions. ADRs start from here.- Existing docs: split into one-concept files, add frontmatter, add
code:refs you've verified exist, and link related files. Tighten them to the style, but keep the facts. - Tags: derive 10โ20 tags from what the docs actually cover.
Write them into
docs/tags.md, one line each. - Log as papercuts anything that confused you during this pass.
- Report: files created or split, tiers run and their observed results, proposed oracles, tags chosen, papercuts logged, open doubts.
Make it one commit (or a small series), separate from code changes.