scaffolding-project

Scaffolding a Project

Creates the standard file structure for a rageatc-code-oss project — run once per new project, before architecture and decomposition. The scaffold creates empty templates and a pre-populated CLAUDE.md; content is filled in by later skills (managing-product → PRD, architecting-software → ARCHITECTURE, decomposing-work/enriching-roadmap → ROADMAP, planning-software → ORCHESTRATION-PLAN). Not for projects with files already in place — check first.

Inputs Required

1. Project root path — absolute path where files will be created
2. Project name — used to populate CLAUDE.md heading
3. Workflow tier — Quick, Standard, or Thorough (determines whether docs/decisions/ is created)

Outputs Produced

<project-root>/
├── CLAUDE.md               # Pre-populated orchestrator orientation file
├── STATUS.md               # Living project state — current position, decisions, next steps
├── PRD.md                  # Empty template — managed by managing-product
├── ARCHITECTURE.md         # Empty template — managed by architecting-software
├── ROADMAP.md              # Empty template — managed by decomposing-work / enriching-roadmap
├── ORCHESTRATION-PLAN.md   # Empty template — managed by planning-software
├── LEARNINGS.md            # Empty, updated only when noteworthy
└── docs/
    └── decisions/          # Created only for Thorough tier (for ADRs)

Workflow

Step 1: Confirm inputs

Check that you have:

• Project root path (absolute)
• Project name
• Workflow tier (Quick / Standard / Thorough)

If any are missing, ask before proceeding.

Step 2: Check for existing files

Before creating anything, check whether the project root already contains any of the target files. If existing files are present, stop and confirm with the orchestrator which files to create. Do not overwrite without explicit approval.

Step 3: Create the directory structure

Create the project root if it does not exist. For Thorough tier only, also create docs/decisions/.