Archived
Lucas WintherandClaude Opus 5
895eabcb69
Empty repository: no commits, no stack. Establishes AGENTS.md as the single source of truth, thin CLAUDE.md/GEMINI.md pointers, permission config, and the docs/ progressive-disclosure tree. Commands section is deliberately unfilled — no stack exists to verify commands against. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
1.4 KiB
1.4 KiB
TODO
Durable backlog. Agents append here instead of leaving TODO comments in source.
Small, specific, independently actionable. Remove only when actually done.
Now
- Answer the open questions in the bootstrap report, then fill the
Commandssection ofAGENTS.mdand delete itsTODO(maintainer)line. - Brainstorm -> spec
docs/specs/001-*.mdcovering the open design questions indocs/ARCHITECTURE.md, starting with collection isolation and the stack choice.
Next
- Scaffold the chosen stack; verify install/dev/test/lint/typecheck/build commands by running them,
then record the verified ones in
AGENTS.md. - Dockerfile + compose: Recoll in the image, volumes for documents and indexes.
- Write
PRODUCT.mdproperly via/impeccable init— the current file is a stub from the initial brief, not an interview.
Someday
- Propose a CI check (Gitea Actions): assert
AGENTS.md,CLAUDE.md,GEMINI.mdand thedocs/paths exist, and fail ifAGENTS.mdexceeds 150 lines.
Known issues
- None recorded yet.
Recurring
- Add an
AGENTS.mdrule only in response to a real, observed agent failure — one line, ideally with a code example. Never pre-empt hypothetical mistakes. - Update
AGENTS.mdin the same commit as the convention it describes. A stale rules file misleads. - Prune quarterly: delete rules whose convention changed or whose mistake no longer occurs.