Built-in Profiles
Compare the complete basic@1 and mattpocock@1 documentation policies distributed with Presswork.
Presswork provides two complete Built-in Profiles. Selecting mattpocock@1 replaces basic@1; it does not inherit or merge any Basic Profile policy.
Comparison
| Contract | basic@1 |
mattpocock@1 |
|---|---|---|
| Markdown Dialect | github |
github |
| Documentation Directories | docs |
docs/adr |
| Root Documents | AGENTS.md, CONTEXT.md, ARCHITECTURE.md, DESIGN.md |
CONTEXT.md, CONTEXT-MAP.md |
| Document Types | None | Non-strict adr |
| Index Policies | docs uses root AGENTS.md, section Source Of Truth Map |
None |
| Declarative requirements | None | ADR numbering, structure, title slug, and status; context document structure |
| Missing locations | Valid; they contribute no Recognized Documents | Valid; all declared locations are lazy |
Both Profiles apply the generic Markdown destination, Document Type, Template, and documentation index Rules. A repository can add declarations through Presswork Configuration, but configuration cannot replace built-in Document Types or requirements.
basic@1
The Basic Profile recognizes Markdown recursively under docs and recognizes AGENTS.md, CONTEXT.md, ARCHITECTURE.md, and DESIGN.md at the Repository Root. Its enabled docs Index Policy uses root AGENTS.md as the Index Document and Source Of Truth Map as the Index Section.
It defines no built-in Document Types, Templates, or declarative requirements. presswork create --list-types therefore returns an empty catalog unless presswork.json adds Document Types.
mattpocock@1
The Matt Pocock Profile recognizes docs/adr plus root CONTEXT.md and CONTEXT-MAP.md. All three locations are optional. It defines no Index Policies.
Its non-strict adr Document Type uses docs/adr/{{number}}-{{slug}}.md, a bundled Template, and the domain-modeling external Creation Policy. Required creation fields are number, slug, title, and decision. Because the Creation Policy is external, Presswork validates ADRs but refuses to initialize them.
Canonical ADR numbers start at 0001, remain unique, and form a contiguous sequence. Each ADR has exactly one H1 followed by a one-to-three-sentence decision paragraph. The filename slug must match the H1 after Presswork’s title normalization. Optional frontmatter status is proposed, accepted, deprecated, or superseded by ADR-NNNN. The bundled Template permits optional Considered Options and Consequences sections.
When present, CONTEXT.md requires one H1, a one-to-two-sentence description, one Language H2, and at least one **Term**: definition with authored prose. An _Avoid_: list is optional but cannot be empty. Lower-level grouping is optional.
When present, CONTEXT-MAP.md requires the exact H1 Context Map, one Contexts H2 with described repository-local links to CONTEXT.md documents, and one Relationships H2 with described relationships using → or ->.
Use Profiles for selection semantics or Configuring Presswork to select a Built-in Profile.