# Clauding Manifesto

> How to set up your project for successful agentic engineering. Short rules that keep a repo's knowledge agent-usable and its 'done' provable: QA.md, architecture, ADRs, papercuts, small tagged docs, freshness.

## Manifesto

- [Catch-up prompt](https://mojzis.github.io/clauding/catch-up/index.md): adoption
- [Evolving practices](https://mojzis.github.io/clauding/evolving/index.md): evolving
- [Ideas inbox: capture, don't act](https://mojzis.github.io/clauding/evolving/ideas-inbox/index.md): evolving, ideas
- [Session handoff: next-session.md + sessions/](https://mojzis.github.io/clauding/evolving/session-handoff/index.md): evolving, handoff
- [Clauding Manifesto](https://mojzis.github.io/clauding/index.md): meta
- [ADRs: decisions from the baseline onward](https://mojzis.github.io/clauding/principles/adr/index.md): principle, adr
- [Architecture: how the system is now](https://mojzis.github.io/clauding/principles/architecture/index.md): principle, architecture
- [Freshness: docs point at code](https://mojzis.github.io/clauding/principles/freshness/index.md): principle, freshness
- [Knowledge: small, linked, tagged files](https://mojzis.github.io/clauding/principles/knowledge/index.md): principle, knowledge
- [Papercuts: log friction when you hit it](https://mojzis.github.io/clauding/principles/papercuts/index.md): principle, papercuts
- [QA: evidence, not a green checkmark](https://mojzis.github.io/clauding/principles/qa/index.md): qa, principle
- [Project knowledge](https://mojzis.github.io/clauding/rules/v1/index.md)
- [principles](https://mojzis.github.io/clauding/principles/index.md)
- [rules](https://mojzis.github.io/clauding/rules/index.md)

## This repo's own docs

- [Docs index](https://mojzis.github.io/clauding/docs/index.md): meta
- [0001: Manifesto lives in its own repo, not in aesop](https://mojzis.github.io/clauding/docs/adr/0001-separate-repo-from-aesop/index.md): meta, site
- [0002: Rules are inlined in each repo, with a version marker](https://mojzis.github.io/clauding/docs/adr/0002-rules-inlined-with-version-marker/index.md): rules, adoption
- [0003: Architecture baseline; no backfilled ADRs](https://mojzis.github.io/clauding/docs/adr/0003-architecture-baseline-no-backfilled-adrs/index.md): adr, architecture, adoption
- [0004: Docs point at code, never the reverse](https://mojzis.github.io/clauding/docs/adr/0004-docs-to-code-links-only/index.md): freshness, knowledge
- [0005: Controlled tag vocabulary in docs/tags.md](https://mojzis.github.io/clauding/docs/adr/0005-controlled-tag-vocabulary/index.md): knowledge
- [0006: QA answers three questions: tiers, expect, oracles](https://mojzis.github.io/clauding/docs/adr/0006-qa-three-questions/index.md): qa
- [0007: Catch-up records only what it observed](https://mojzis.github.io/clauding/docs/adr/0007-catch-up-never-invents/index.md): adoption
- [0008: QA.md lives at the project root](https://mojzis.github.io/clauding/docs/adr/0008-qa-md-at-project-root/index.md): qa
- [0009: Markdown is the only source of truth; checker keeps no index](https://mojzis.github.io/clauding/docs/adr/0009-markdown-only-source-of-truth/index.md): tooling
- [0010: Site built by a small Python script, published with raw markdown](https://mojzis.github.io/clauding/docs/adr/0010-static-site-python-build/index.md): site
- [0011: Practices on trial live in an evolving section, outside the rules](https://mojzis.github.io/clauding/docs/adr/0011-evolving-practices-section/index.md): evolving, rules
- [Architecture](https://mojzis.github.io/clauding/docs/architecture/index.md): architecture
- [Brief: project-knowledge rules ("agentic engineering manifesto")](https://mojzis.github.io/clauding/docs/brief/index.md): meta
- [Checker flags adopter repos whose hook skips markdown](https://mojzis.github.io/clauding/docs/ideas/2026-10-15-checker-catches-python-only-hooks/index.md): ideas, tooling
- [Ideas](https://mojzis.github.io/clauding/docs/ideas/index.md): ideas
- [Next session](https://mojzis.github.io/clauding/docs/next-session/index.md): handoff
- [Catch-up says don't fix; rules say fix trivial ones inline](https://mojzis.github.io/clauding/docs/papercuts/catch-up-vs-inline-fix/index.md): adoption, papercuts
- [Docs-only commits passed the hook unchecked](https://mojzis.github.io/clauding/docs/papercuts/docs-commits-unchecked/index.md): dev, papercuts
- [Rules example uses a tag the seed vocabulary lacks](https://mojzis.github.io/clauding/docs/papercuts/rules-example-tag-not-in-vocab/index.md): rules, knowledge
- [Sessions](https://mojzis.github.io/clauding/docs/sessions/index.md): handoff
- [Writing style for docs](https://mojzis.github.io/clauding/docs/style/index.md): meta
- [Tag vocabulary](https://mojzis.github.io/clauding/docs/tags/index.md): meta
- [Dev toolbox](https://mojzis.github.io/clauding/docs/toolbox/index.md): dev
- [adr](https://mojzis.github.io/clauding/docs/adr/index.md)
- [papercuts](https://mojzis.github.io/clauding/docs/papercuts/index.md)