Bring the six design documents in from .github-private
What this is
The six design documents of the Factory, moved here from petry-projects/.github-private, where they were written on the draft pull request "docs: factory MVP ā PRD, architecture review, market research and ADR-0013 (proposed)" (number 2225), at commit 7d7d04f.
| Document | Role |
|---|---|
docs/architecture/software-factory-design.md | The design. Build from its rules (Ā§1.2 says which sections are rules and which are record) |
docs/architecture/adr/0013-factory-mvp-reference-architecture.md | The decisions |
docs/prd/agentic-software-factory.md | The requirements |
docs/architecture/software-factory-architecture.md | The architecture document, in progress |
docs/architecture/factory-mvp-architecture-review.md | History. Nothing is built from it |
docs/research/market-agentic-software-factories-research-2026-10-10.md | Market research |
What changed in the move
- Paths are kept, so the documents' links to each other resolve. Checked: no relative link to a
.mdfile is broken. - Each document gains one line saying where it was first written. That line is the only change; the rest is byte-for-byte what was on the source commit.
- Citations of files and lines in
.github-privateare left as written. They are evidence about the current system and say which repo they mean. - Nothing else is copied from
.github-private.
Verification
make verify passes on this branch. There is no required check on main yet; the workflow and the ruleset come next.
Known and not fixed here
The context check on the local branch slice-0/context-engineering (tools/check_context.py, not yet on GitHub) reads everything under docs/ as context an author is told to read. Merged with this branch it reports 70 problems in three of these documents: 69 names of files that are not in this repo, and one bare pull-request number. The documents are record and cite another repo on purpose, so the fix belongs in that check, not here.
š¤ Generated with Claude Code