Skip to content

Add section-map skill: C4 component map of one section - #2223

Merged
peterdrier merged 2 commits into
mainfrom
claude/project-thread-ulbiuw
Oct 31, 2026
Merged

peterdrier merged 2 commits into
mainfrom
claude/project-thread-ulbiuw

Conversation

@peterdrier

Copy link
Copy Markdown
Owner

Requested by Peter · project thread

What

Adds .claude/skills/section-map/SKILL.md. It draws one section as a C4 component diagram (screens on top, services in the middle, repository at the bottom, neighbouring sections in a slim column, public interfaces on the section boundary), followed by short data-flow walkthroughs, view and service tables, and drift findings last.

Why

It gives a developer about to change a section a picture of how it works today. The draft prompt was iterated on trial runs of Teams and Cantina (published as artifacts in the thread).

Existing surface checked

No new durable surface. One skill file only; section-doctor stays as it is.

Checklist

  • Review tier stated: tier:lightweight (one skill file, no code).
  • No migration edited by hand: no migrations.
  • No NOT NULL column: no schema.
  • Section labeled: not section code.
  • Targeting main on peterdrier/Humans.
  • Branched off origin/main.
  • Build + test: docs-only, no build needed.

Reviewer notes

Still a draft for Peter to read. The output path (src/Sections/Humans.<Section>/Docs/map.html) is the recommendation on an open question in the thread, and may change.


Generated by Claude Code

Draft from the trial runs on Teams and Cantina: screens on top, services
in the middle, repository at the bottom, neighbours in a slim column,
public interfaces on the section boundary, walkthroughs, drift last.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_0186neA795R7Sjqt4qB9GkgL
@peterdrier peterdrier self-assigned this Oct 30, 2026
@github-actions

github-actions Bot commented Oct 30, 2026 •

Copy link
Copy Markdown

PR Surface Report

Compared f71de1eb...20462af4. Scored with reforge 0.29.0.

Summary: 1 changed file(s) | EF migrations: 0 added file(s), max 0/1 per context

Reforge Surface Score

metric base head delta
total 17728 17728 0
surface 13954 13954 0
internal complexity 3774 3774 0

Section Deltas

No section score changes.

Section Size & Complexity Deltas

No section size/complexity changes.

Rule Deltas

No rule score changes.

Published Write Surface

6 of 51 sections publish write capability, 7 interfaces (0).

Interface Surface

No new interfaces or interface members.

Diff Size

bucket added deleted
docs 99 0

New Files

  • .claude/skills/section-map/SKILL.md

From the Camps trial run.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_0186neA795R7Sjqt4qB9GkgL
@peterdrier
peterdrier merged commit b2eb9b9 into main Oct 31, 2026
6 checks passed
@peterdrier
peterdrier deleted the claude/project-thread-ulbiuw branch October 31, 2026 00:14
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants