new-project

---
name: new-project
description: 'Use when the task matches skill: new project scaffold and this skill''s local workflow.'
metadata:
  use_when: 'Use when the task matches skill: new project scaffold and this skill''s local workflow.'
  do_not_use_when: Do not use when a more specific upstream or downstream skill owns the task, or when the required project context has not been prepared.
  required_inputs: Provide the target project or document, the relevant context files, scope constraints, and any domain or standards inputs referenced here.
  workflow: Follow the ordered steps, review gates, and local generation logic in this file before consulting deeper support files as needed.
  quality_standards: Keep outputs grounded in source context, traceable to stated standards, and specific enough to review or verify.
  anti_patterns: Do not fabricate missing requirements, skip human review gates, or substitute vague prose for verifiable documentation.
  outputs: Produce or update the document, scaffold, analysis, or phase artifact that this skill defines.
  references: Use sibling files in this directory when deeper detail is needed.
  portable: true
  compatible_with:
  - claude-code
  - codex
---

# Skill: New Project Scaffold

<!-- dual-compat-start -->
## Evidence Produced

| Category | Artifact | Format | Example |
| --- | --- | --- | --- |
| Release evidence | Project initialisation evidence pack | Markdown plus filesystem validation | selected methodology, created paths, preserved files, validation result, rollback, and handoff |
<!-- dual-compat-end -->
## Inputs
| Artefact | Required? | Purpose |
|---|---|---|
| Approved project profile and roadmap | yes | Drive scaffold scope |
| Repository conventions and existing files | yes | Preserve local structure |

## Outputs
| Artefact | Consumer | Acceptance condition |
|---|---|---|
| Project documentation scaffold | Project team | No destructive overwrite, links resolve, roadmap represented |

## Capability contract
Read/search are required. File creation requires explicit scaffold authority. Do not install tools, initialise remote services, or publish artefacts implicitly.

## Degraded mode
Fallback without write access: return the directory tree and file templates as a proposed patch.

## Decision rules
| State | Action | Failure avoided |
|---|---|---|
| Empty project | Create approved minimal scaffold | Context overload |
| Existing partial documentation | Fill gaps and preserve content | Destructive replacement |
| Conflicting methodology files | Stop and reconcile with roadmap | Contradictory process |

## Domain anti-patterns
- Creating empty placeholder documents. Fix: include purpose, owner, and next action.
- Copying a universal scaffold. Fix: derive files from the approved roadmap.
- Replacing existing project rules. Fix: preserve and reconcile them.
- Adding tool-specific adapters as canonical truth. Fix: keep sources model-neutral.
- Claiming setup is complete without link checks. Fix: validate the scaffold and references.

## Trigger
User says any of: "start a new project", "create a new project",
"scaffold a project", "new client project", "initialize project"

## First Step: Shared Understanding
Start with the engine's own design gate: `skills/sdlc-meta/world-class-engineering`
§2 "Create Shared Understanding". Record user journeys, non-goals, scale and trust
boundaries, ranked quality attributes and hard constraints, and state the ceremony
class (spike, bounded or architectural) before scaffolding anything.
If the Superpowers plugin is present, its process skills (for example
`superpowers:brainstorming`) may be used; this engine's gates remain authoritative.

---

## How to Use the Chwezi SDLC Documentation engine (PRIME Workflow)

Every skill in this engine follows the **PRIME methodology** (Kodukula & Vinueza, 2024):

| Step | What the Consultant Does | Chwezi SDLC Documentation Equivalent |
|------|--------------------------|----------------------|
| **P — Prepare** | Gather all project data before prompting | Populate `_context/` files with real stakeholder data, not placeholders |
| **R — Relay** | Submit the prompt with precise instructions | Invoke the SKILL.md (tell Claude: "Run the [skill name] skill") |
| **I — Inspect** | Critically evaluate AI output against objectives | Read the generated document; check it against `_context/` source files |
| **M — Modify** | Refine if output diverges from expectations | Edit the output or update `_context/` and re-invoke the skill |
| **E — Execute** | Approve and build the final artifact | Run `build-doc.sh` to produce the `.docx` |

> **Quality rule:** Never execute (build the `.docx`) without completing Inspect and Modify. The first AI output is a draft, not a deliverable.

The `_context/` directory is the **Project Input Folder (PIF)** for this project — a living repository of project-specific context that feeds every skill. The richer the PIF, the higher the quality of every generated document (Kodukula & Vinueza, 2024).

---

## Interview Protocol

After brainstorming, ask these questions ONE AT A TIME. Do not ask the next until
the previous is answered.

**Q1:** What is the project name? (This becomes the directory name — use hyphens,
e.g., `Livecare-Hospital-ERP`)

**Q2:** In 2–3 sentences, what does this software do and what problem does it solve?
(This pre-populates `_context/vision.md` and is used to deduce the domain)

**Q3:** Which methodology best fits this project?
- A) **Waterfall** — regulated industry, fixed scope, formal IEEE 830 SRS required
- B) **Agile** — iterative delivery, user stories, Scrum/Kanban
- C) **Hybrid** — formal SRS for backend/core + agile user stories for frontend/features

**Q4:** Who is the project owner / primary client contact name?

---

## Domain Deduction (NO USER INPUT REQUIRED)

After Q2, Claude analyses the project description and deduces the domain automatically
using these signals:

| If description mentions... | Deduce domain |
|---|---|
| patients, hospitals, clinics, EMR, EHR, PHI, medical, healthcare, pharmacy, nursing | `healthcare` |
| banking, payments, ledger, transactions, trading, insurance, loans, fintech, accounting | `finance` |
| students, courses, LMS, grades, enrollment, university, school, e-learning | `education` |
| inventory, POS, e-commerce, retail, products, orders, cart, warehouse (retail context) | `retail` |
| fleet, shipments, tracking, logistics, freight, warehouse (supply chain), delivery, routing | `logistics` |
| government, citizens, public services, procurement, permits, case management, municipal | `government` |
| farm, crops, livestock, agriculture, harvest, planting, irrigation, cattle, poultry, FMIS | `agriculture` |

**If ambiguous (two domains equally match):** Ask the user during the brainstorming
session — e.g., "This sounds like it could be healthcare OR government — which primary
domain applies?"

**If no domain matches:** Use `other` — no domain defaults are injected; scaffold
only the directory structure and empty context files.

---

## Additional Guidance

Extended project-scaffold guidance was moved to [references/new-project-deep-dive.md](references/new-project-deep-dive.md) to keep this entrypoint compact and fast to load.

Use that deep dive for:
- `Scaffold Actions`
- `Quick Links`
- `What We Are Building`
- `Document Inventory by Phase`
- `Context Files (`_context/`)`
- `Progress Summary`
- `Immediate Next Steps`
- `Problem Statement`
- `Goals`
- `Stakeholders`
- `Success Criteria`
- `Feature Name`
- Additional deep-dive sections continue in the reference file.

• SKILL.md 7 KB
• examples/education-lms/CONTRIBUTING.md 1 KB
• examples/education-lms/README.md 1 KB
• examples/education-lms/02-requirements-engineering/srs/3.2-functional-requirements.md 1 KB
• examples/education-lms/03-design-documentation/threat-model.md 1 KB
• examples/education-lms/03-design-documentation/03-api-specification/claims-api.md 1 KB
• examples/education-lms/03-design-documentation/04-database-design/schema.md 1 KB
• examples/education-lms/03-design-documentation/05-ux-specification/ui-spec.md 1 KB
• examples/education-lms/03-design-documentation/adr/ADR-001-use-postgres.md 1 KB
• examples/education-lms/04-development/coding-standards.md 1 KB
• examples/education-lms/04-development/env-setup.md 1 KB
• examples/education-lms/05-testing-documentation/29119-deterministic-checks.md 1 KB
• examples/education-lms/05-testing-documentation/coverage-matrix.md 1 KB
• examples/education-lms/05-testing-documentation/test-completion-report.md 1 KB
• examples/education-lms/05-testing-documentation/test-plan/tc.md 1 KB
• examples/education-lms/06-deployment-operations/deployment-guide.md 1 KB
• examples/education-lms/06-deployment-operations/go-live-readiness.md 1 KB
• examples/education-lms/06-deployment-operations/infrastructure.md 1 KB
• examples/education-lms/06-deployment-operations/monitoring.md 1 KB
• examples/education-lms/06-deployment-operations/runbook.md 1 KB
• examples/education-lms/06-deployment-operations/incident-response/playbook.md 1 KB
• examples/education-lms/07-agile-artifacts/definition-of-done.md 1 KB
• examples/education-lms/07-agile-artifacts/definition-of-ready.md 1 KB
• examples/education-lms/07-agile-artifacts/retrospective.md 1 KB
• examples/education-lms/07-agile-artifacts/sprint-plan.md 1 KB
• examples/education-lms/07-agile-artifacts/velocity.md 1 KB
• examples/education-lms/08-end-user-documentation/faq.md 1 KB
• examples/education-lms/08-end-user-documentation/release-notes.md 1 KB
• examples/education-lms/08-end-user-documentation/user-manual.md 1 KB
• examples/education-lms/09-governance-compliance/03-compliance.md 1 KB
• examples/education-lms/09-governance-compliance/audit-report.md 1 KB
• examples/education-lms/09-governance-compliance/risk-register.md 1 KB
• examples/education-lms/_context/domain.md 1 KB
• examples/education-lms/_context/features.md 1 KB
• examples/education-lms/_context/glossary.md 1 KB
• examples/education-lms/_context/methodology.md 1 KB
• examples/education-lms/_context/quality-standards.md 1 KB
• examples/education-lms/_context/stakeholders.md 1 KB
• examples/education-lms/_context/vision.md 1 KB
• examples/education-lms/_registry/controls.yaml 1 KB
• examples/finance-erp/CONTRIBUTING.md 1 KB
• examples/finance-erp/README.md 1 KB
• examples/finance-erp/02-requirements-engineering/srs/3.2-functional-requirements.md 1 KB
• examples/finance-erp/03-design-documentation/threat-model.md 1 KB
• examples/finance-erp/03-design-documentation/03-api-specification/claims-api.md 1 KB
• examples/finance-erp/03-design-documentation/04-database-design/schema.md 1 KB
• examples/finance-erp/03-design-documentation/05-ux-specification/ui-spec.md 1 KB
• examples/finance-erp/03-design-documentation/adr/ADR-001-use-postgres.md 1 KB
• examples/finance-erp/04-development/coding-standards.md 1 KB
• examples/finance-erp/04-development/env-setup.md 1 KB
• examples/finance-erp/05-testing-documentation/29119-deterministic-checks.md 1 KB
• examples/finance-erp/05-testing-documentation/coverage-matrix.md 1 KB
• examples/finance-erp/05-testing-documentation/test-completion-report.md 1 KB
• examples/finance-erp/05-testing-documentation/test-plan/tc.md 1 KB
• examples/finance-erp/06-deployment-operations/deployment-guide.md 1 KB
• examples/finance-erp/06-deployment-operations/go-live-readiness.md 1 KB
• examples/finance-erp/06-deployment-operations/infrastructure.md 1 KB
• examples/finance-erp/06-deployment-operations/monitoring.md 1 KB
• examples/finance-erp/06-deployment-operations/runbook.md 1 KB
• examples/finance-erp/06-deployment-operations/incident-response/playbook.md 1 KB
• examples/finance-erp/07-agile-artifacts/definition-of-done.md 1 KB
• examples/finance-erp/07-agile-artifacts/definition-of-ready.md 1 KB
• examples/finance-erp/07-agile-artifacts/retrospective.md 1 KB
• examples/finance-erp/07-agile-artifacts/sprint-plan.md 1 KB
• examples/finance-erp/07-agile-artifacts/velocity.md 1 KB
• examples/finance-erp/08-end-user-documentation/faq.md 1 KB
• examples/finance-erp/08-end-user-documentation/release-notes.md 1 KB
• examples/finance-erp/08-end-user-documentation/user-manual.md 1 KB
• examples/finance-erp/09-governance-compliance/03-compliance.md 1 KB
• examples/finance-erp/09-governance-compliance/audit-report.md 1 KB
• examples/finance-erp/09-governance-compliance/risk-register.md 1 KB
• examples/finance-erp/_context/domain.md 1 KB
• examples/finance-erp/_context/features.md 1 KB
• examples/finance-erp/_context/glossary.md 1 KB
• examples/finance-erp/_context/methodology.md 1 KB
• examples/finance-erp/_context/quality-standards.md 1 KB
• examples/finance-erp/_context/stakeholders.md 1 KB
• examples/finance-erp/_context/vision.md 1 KB
• examples/finance-erp/_registry/controls.yaml 1 KB
• examples/healthcare-saas/CONTRIBUTING.md 1 KB
• examples/healthcare-saas/README.md 1 KB
• examples/healthcare-saas/02-requirements-engineering/srs/3.2-functional-requirements.md 1 KB
• examples/healthcare-saas/03-design-documentation/threat-model.md 1 KB
• examples/healthcare-saas/03-design-documentation/03-api-specification/claims-api.md 1 KB
• examples/healthcare-saas/03-design-documentation/04-database-design/schema.md 1 KB
• examples/healthcare-saas/03-design-documentation/05-ux-specification/ui-spec.md 1 KB
• examples/healthcare-saas/03-design-documentation/adr/ADR-001-use-postgres.md 1 KB
• examples/healthcare-saas/04-development/coding-standards.md 1 KB
• examples/healthcare-saas/04-development/env-setup.md 1 KB
• examples/healthcare-saas/05-testing-documentation/29119-deterministic-checks.md 1 KB
• examples/healthcare-saas/05-testing-documentation/coverage-matrix.md 1 KB
• examples/healthcare-saas/05-testing-documentation/test-completion-report.md 1 KB
• examples/healthcare-saas/05-testing-documentation/test-plan/tc.md 1 KB
• examples/healthcare-saas/06-deployment-operations/deployment-guide.md 1 KB
• examples/healthcare-saas/06-deployment-operations/go-live-readiness.md 1 KB
• examples/healthcare-saas/06-deployment-operations/infrastructure.md 1 KB
• examples/healthcare-saas/06-deployment-operations/monitoring.md 1 KB
• examples/healthcare-saas/06-deployment-operations/runbook.md 1 KB
• examples/healthcare-saas/06-deployment-operations/incident-response/playbook.md 1 KB
• examples/healthcare-saas/07-agile-artifacts/definition-of-done.md 1 KB
• examples/healthcare-saas/07-agile-artifacts/definition-of-ready.md 1 KB
• examples/healthcare-saas/07-agile-artifacts/retrospective.md 1 KB
• examples/healthcare-saas/07-agile-artifacts/sprint-plan.md 1 KB
• examples/healthcare-saas/07-agile-artifacts/velocity.md 1 KB
• examples/healthcare-saas/08-end-user-documentation/faq.md 1 KB
• examples/healthcare-saas/08-end-user-documentation/release-notes.md 1 KB
• examples/healthcare-saas/08-end-user-documentation/user-manual.md 1 KB
• examples/healthcare-saas/09-governance-compliance/03-compliance.md 1 KB
• examples/healthcare-saas/09-governance-compliance/audit-report.md 1 KB
• examples/healthcare-saas/09-governance-compliance/risk-register.md 1 KB
• examples/healthcare-saas/_context/domain.md 1 KB
• examples/healthcare-saas/_context/features.md 1 KB
• examples/healthcare-saas/_context/glossary.md 1 KB
• examples/healthcare-saas/_context/methodology.md 1 KB
• examples/healthcare-saas/_context/quality-standards.md 1 KB
• examples/healthcare-saas/_context/stakeholders.md 1 KB
• examples/healthcare-saas/_context/vision.md 1 KB
• examples/healthcare-saas/_registry/controls.yaml 1 KB
• examples/uganda-public-sector/CONTRIBUTING.md 1 KB
• examples/uganda-public-sector/README.md 1 KB
• examples/uganda-public-sector/02-requirements-engineering/srs/3.2-functional-requirements.md 1 KB
• examples/uganda-public-sector/03-design-documentation/threat-model.md 1 KB
• examples/uganda-public-sector/03-design-documentation/03-api-specification/claims-api.md 1 KB
• examples/uganda-public-sector/03-design-documentation/04-database-design/schema.md 1 KB
• examples/uganda-public-sector/03-design-documentation/05-ux-specification/ui-spec.md 1 KB
• examples/uganda-public-sector/03-design-documentation/adr/ADR-001-use-postgres.md 1 KB
• examples/uganda-public-sector/04-development/coding-standards.md 1 KB
• examples/uganda-public-sector/04-development/env-setup.md 1 KB
• examples/uganda-public-sector/05-testing-documentation/29119-deterministic-checks.md 1 KB
• examples/uganda-public-sector/05-testing-documentation/coverage-matrix.md 1 KB
• examples/uganda-public-sector/05-testing-documentation/test-completion-report.md 1 KB
• examples/uganda-public-sector/05-testing-documentation/test-plan/tc.md 1 KB
• examples/uganda-public-sector/06-deployment-operations/deployment-guide.md 1 KB
• examples/uganda-public-sector/06-deployment-operations/go-live-readiness.md 1 KB
• examples/uganda-public-sector/06-deployment-operations/infrastructure.md 1 KB
• examples/uganda-public-sector/06-deployment-operations/monitoring.md 1 KB
• examples/uganda-public-sector/06-deployment-operations/runbook.md 1 KB
• examples/uganda-public-sector/06-deployment-operations/incident-response/playbook.md 1 KB
• examples/uganda-public-sector/07-agile-artifacts/definition-of-done.md 1 KB
• examples/uganda-public-sector/07-agile-artifacts/definition-of-ready.md 1 KB
• examples/uganda-public-sector/07-agile-artifacts/retrospective.md 1 KB
• examples/uganda-public-sector/07-agile-artifacts/sprint-plan.md 1 KB
• examples/uganda-public-sector/07-agile-artifacts/velocity.md 1 KB
• examples/uganda-public-sector/08-end-user-documentation/faq.md 1 KB
• examples/uganda-public-sector/08-end-user-documentation/release-notes.md 1 KB
• examples/uganda-public-sector/08-end-user-documentation/user-manual.md 1 KB
• examples/uganda-public-sector/09-governance-compliance/03-compliance.md 1 KB
• examples/uganda-public-sector/09-governance-compliance/audit-report.md 1 KB
• examples/uganda-public-sector/09-governance-compliance/risk-register.md 1 KB
• examples/uganda-public-sector/_context/domain.md 1 KB
• examples/uganda-public-sector/_context/features.md 1 KB
• examples/uganda-public-sector/_context/glossary.md 1 KB
• examples/uganda-public-sector/_context/methodology.md 1 KB
• examples/uganda-public-sector/_context/quality-standards.md 1 KB
• examples/uganda-public-sector/_context/stakeholders.md 1 KB
• examples/uganda-public-sector/_context/vision.md 1 KB
• examples/uganda-public-sector/_registry/controls.yaml 1 KB
• prompts/context-gap-fillers.md 2 KB
• references/new-project-deep-dive.md 20 KB
• templates/controls.yaml.template 1 KB