Skip to content

cheriftj/c4-model-skill / skills/c4-model

c4-model

Verified

FileKindSize
SKILL.mdskill md14.1 KB
examples/01-context.example.mdmarkdown4.7 KB
examples/02-container.example.mdmarkdown7.2 KB
level-template.mdmarkdown2.5 KB
mermaid-c4-syntax.mdmarkdown10.5 KB
mode-design.mdmarkdown4.5 KB
mode-document-code.mdmarkdown4.3 KB
mode-document-prose.mdmarkdown2.5 KB
mode-review.mdmarkdown3.5 KB
mode-update.mdmarkdown2.9 KB
review-checklist.mdmarkdown3.6 KB
supporting-diagrams.mdmarkdown4.1 KB

mode-document-prose.md

View on GitHub
# Mode: Document-prose — retro-documentation from prose

> Produce a C4 from a textual description (README, ADR, spec, meeting transcript, Slack thread, email).

## When to use

- The user provides free-form text describing a system: README, ADR, functional spec, interview transcript, Slack/email thread summarizing an architecture
- No code to scan — the source of truth is the prose
- The goal is to structure what the text describes, not to invent beyond it

If the prose points to a repo, switch to **Document-code** ([`mode-document-code.md`](mode-document-code.md)) after extracting what's in the prose.

## Step 1 — Extraction

Read the prose (pasted in chat, or via `Read` if a path is provided). Extract:

| Category | Signals in prose |
|---|---|
| System and scope | *"the X portal"*, *"the Y platform"* |
| Actors mentioned | *"customers"*, *"support agents"*, *"admins"* |
| External systems | *"via Stripe"*, *"push into Salesforce"*, *"notifications via Twilio"* |
| Candidate containers | *"the frontend"*, *"the API"*, *"the worker"*, *"the database"* |
| Technologies | *"in Node"*, *"Postgres"*, *"RabbitMQ queue"* |
| Explicit flows | *"the frontend calls the API"*, *"the worker consumes events from the queue"* |

Anything ambiguous or absent goes into a "**gaps to fill**" list.

## Step 2 — Validation + gap-filling

Present the findings to the user in **two columns**:
- **What we understood** (reformulated from the prose)
- **What's missing** (explicit gaps)

For each gap, ask by batches of 3-5 (common dialogue rule). **Invent nothing.** If the user doesn't know, it stays in the *Assumptions* section of the document.

## Step 3 — Draft, iterate, finalize

Same cycle as the other modes:
1. Initial draft (Context + Container most often)
2. Dialogue-driven review, iteration
3. Run the [`review-checklist.md`](review-checklist.md)
4. Deliver to the chosen destination

## Tools to use per step

| Step | Tool | Usage |
|---|---|---|
| 1 | `Read` (if a path is provided), direct reading otherwise | Extraction |
| 2-3 | — | Dialogue |
| 3 delivery | `Write` / `mcp__notion__*` / `mcp__linear__save_document` / etc. | Per destination |

## Links

- ← Back: [`SKILL.md`](SKILL.md)
- Deliverable template: [`level-template.md`](level-template.md)
- Filled-out examples: [`examples/`](examples/)
- Detailed Mermaid syntax: [`mermaid-c4-syntax.md`](mermaid-c4-syntax.md)
- Review checklist: [`review-checklist.md`](review-checklist.md)
- If the prose points to a repo: [`mode-document-code.md`](mode-document-code.md)
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 194kUpdated Claude CodeCodexVerifiedInstall