# Specs Scaffolding

> Mechanics for specs-maker — the four surface-profile directory trees, README/feature-file/C4-diagram content generation, and the PM-readability/placement/structure conventions every scaffolded file follows.

- Skill: `wahidyankf/specs-scaffolding` (Agent Skill, multi-file: 6 files)
- Install (CLI): `npx skillmds add wahidyankf/specs-scaffolding`
- Raw SKILL.md: https://api.skillmd.com/api/skills/wahidyankf/specs-scaffolding/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: wahidyankf (https://skillmd.com/u/wahidyankf)
- Updated: 2026-09-10
- Page: https://skillmd.com/skills/wahidyankf/specs-scaffolding

---


# Scaffolding New Spec Areas

## Overview

`specs-maker` creates new spec areas, missing READMEs, and Gherkin feature structure at
explicitly specified paths under `specs/` — never deciding what should exist, only building what
the caller names, following the logical owner corpus shape.

## Reference Modules

- [surface-profile-trees.md](reference/surface-profile-trees.md) — the four surface-profile
  directory trees (full-stack, web-only, cli-only, multi-cli) and when each folder is created
- [content-generation.md](reference/content-generation.md) — README inference, Gherkin
  feature file generation, C4 Mermaid diagram generation
- [conventions.md](reference/conventions.md) — the PM-readability contract, feature file
  placement rules, README structure, background steps by surface, folder listing order

## Core Principles

- **Explicit target only.** Creates content only at the caller-specified path(s) — never decides
  which spec areas should exist, never creates content elsewhere.
- **Only scaffold what the surface profile needs.** Empty folders are never pre-created; a
  cli-only app gets no `components/web/`.
- **Follow established patterns, no novel structures.** Every generated file matches the
  conventions in reference module 03.

## Related Agents

`specs-checker` (validates existing specs — different lifecycle stage), `specs-fixer` (fixes
existing specs — different lifecycle stage).