Project-Meta — Index
Repo lifecycle, documentation, and onboarding for Persimmon projects. This mother is a map; follow the child for the actual work.
Trigger
- "Start a new client project" / "onboard" / "SOW"
- "Audit the docs" / "update README" / "add an ADR"
- "Walk me through this project" / "where does X come from?"
- "Write the deployment plan / go-live doc"
- "Set up / sync the Persimmon skills"
The child skills
| Skill |
When to use |
Owns |
meta-new-client-project |
New engagement |
GitHub repo in the org, clone, scaffold docs, register in CLAUDE.md/README |
meta-document-project |
Doc maintenance |
Lean doc audit/scaffold/update — enforces Persimmon doc conventions |
meta-project-xray |
Understanding a codebase |
Interactive guided walk-through of pages, data flows, integrations |
meta-adr-authoring |
Recording a decision |
MADR-lite ADRs in docs/decisions/ for non-obvious choices |
meta-deployment-plan |
Go-live |
Client-facing deployment plan document with sign-off |
meta-skill-sync |
Wiring skills into a project |
Install the Persimmon plugin (marketplace), verify activation, onboard a dev |
How to route
- Brand-new project? →
meta-new-client-project, then the master persimmon lifecycle tree.
- Docs drifting / missing? →
meta-document-project.
- Need to understand the code? →
meta-project-xray.
- Non-obvious decision? →
meta-adr-authoring.
- Shipping to the client? →
meta-deployment-plan (+ quality-final-review).
- Skills not active in a repo? →
meta-skill-sync.
Doc conventions — one-screen summary (every client folder gets exactly)
CLAUDE.md — dev context (starts with a "What This File Is" preamble)
README.md — human onboarding (status table, team, docs table)
docs/reference/scope-of-work.md — signed SOW (ONLY place for financials)
docs/decisions/ — ADRs (MADR-lite)
docs/specs/ & docs/plans/ — workflow artifacts (see workflow)
notes/ — meeting notes, requirements
.github/workflows/ci.yml — lint, typecheck, prisma validate, build
Never put payment terms in README, architecture in README (link to CLAUDE.md), or client contact info in CLAUDE.md.
Anti-patterns banned
- Financials anywhere but
docs/reference/scope-of-work.md
- Architecture in README instead of CLAUDE.md
- Undocumented non-obvious decisions (write an ADR)
- Hand-wiring skills via invalid settings keys — use
meta-skill-sync (plugin install)
Relationship to other mothers
| Mother |
Connection |
workflow |
Specs/plans live alongside the docs this mother manages |
quality |
meta-deployment-plan pairs with quality-final-review |
| all |
meta-new-client-project kicks off the full master lifecycle |
1---2name: project-meta3description: Project-Meta — Index4---56# Project-Meta — Index78Repo lifecycle, documentation, and onboarding for Persimmon projects. This mother is a map; follow the child for the actual work.910## Trigger1112- "Start a new client project" / "onboard" / "SOW"13- "Audit the docs" / "update README" / "add an ADR"14- "Walk me through this project" / "where does X come from?"15- "Write the deployment plan / go-live doc"16- "Set up / sync the Persimmon skills"1718## The child skills1920| Skill | When to use | Owns |21|---|---|---|22| `meta-new-client-project` | New engagement | GitHub repo in the org, clone, scaffold docs, register in CLAUDE.md/README |23| `meta-document-project` | Doc maintenance | Lean doc audit/scaffold/update — enforces Persimmon doc conventions |24| `meta-project-xray` | Understanding a codebase | Interactive guided walk-through of pages, data flows, integrations |25| `meta-adr-authoring` | Recording a decision | MADR-lite ADRs in `docs/decisions/` for non-obvious choices |26| `meta-deployment-plan` | Go-live | Client-facing deployment plan document with sign-off |27| `meta-skill-sync` | Wiring skills into a project | Install the Persimmon plugin (marketplace), verify activation, onboard a dev |2829## How to route30311. **Brand-new project?** → `meta-new-client-project`, then the master `persimmon` lifecycle tree.322. **Docs drifting / missing?** → `meta-document-project`.333. **Need to understand the code?** → `meta-project-xray`.344. **Non-obvious decision?** → `meta-adr-authoring`.355. **Shipping to the client?** → `meta-deployment-plan` (+ `quality-final-review`).366. **Skills not active in a repo?** → `meta-skill-sync`.3738## Doc conventions — one-screen summary (every client folder gets exactly)3940- `CLAUDE.md` — dev context (starts with a "What This File Is" preamble)41- `README.md` — human onboarding (status table, team, docs table)42- `docs/reference/scope-of-work.md` — signed SOW (ONLY place for financials)43- `docs/decisions/` — ADRs (MADR-lite)44- `docs/specs/` & `docs/plans/` — workflow artifacts (see `workflow`)45- `notes/` — meeting notes, requirements46- `.github/workflows/ci.yml` — lint, typecheck, `prisma validate`, build4748**Never put** payment terms in README, architecture in README (link to CLAUDE.md), or client contact info in CLAUDE.md.4950## Anti-patterns banned5152- Financials anywhere but `docs/reference/scope-of-work.md`53- Architecture in README instead of CLAUDE.md54- Undocumented non-obvious decisions (write an ADR)55- Hand-wiring skills via invalid settings keys — use `meta-skill-sync` (plugin install)5657## Relationship to other mothers5859| Mother | Connection |60|---|---|61| `workflow` | Specs/plans live alongside the docs this mother manages |62| `quality` | `meta-deployment-plan` pairs with `quality-final-review` |63| all | `meta-new-client-project` kicks off the full master lifecycle |