claudeos-core 2.2.0 → 2.3.1

package/pass-prompts/templates/common/pass3b-core-header.md

@@ -51,6 +51,49 @@ MUST match the fact sheet exactly. If `pass3a-facts.md` says
 `controller-patterns.md`, `response-exception.md`, and
 `controller-rules.md` MUST all show Controller wrapping the response.
 
+## CLAUDE.md Section 6 — Skills sub-section (entry point only)
+
+The Skills sub-section inside CLAUDE.md Section 6 is an **entry point**,
+not a full registry. Pass 3c has not yet run when Section 6 is being
+written, so the specific sub-skill filenames (e.g. `01.dto.md`,
+`02.mapper-read.md`) do not exist and must NOT be predicted. Listing
+sub-skills here by name always produces one of two bugs:
+
+1. Hallucinated filenames when Pass 3c picks a different breakdown than
+   the one predicted (e.g. `01.entity.md` written here, `01.dto.md`
+   generated by Pass 3c → mismatch → MANIFEST_DRIFT).
+
+2. Silent staleness when Pass 3c adds or removes a sub-skill later and
+   CLAUDE.md is not regenerated — the listed names diverge from
+   MANIFEST and the drift is user-visible.
+
+### What to write in Section 6 — Skills
+
+List ONLY:
+- `claudeos-core/skills/00.shared/MANIFEST.md` — the skill registry
+- The orchestrator file(s) for any skill that has sub-skills, with a
+  short one-line role description. Example:
+  `claudeos-core/skills/10.backend-crud/01.scaffold-crud-feature.md`
+  — CRUD scaffolding orchestrator (sub-skills registered in MANIFEST).
+- Standalone skills (skills without sub-skills), if any exist and can
+  be verified from the Pass 3c scope described in the stack template.
+
+### What NOT to write in Section 6 — Skills
+
+- Do NOT list individual sub-skill files
+  (`scaffold-crud-feature/01.dto.md`,
+  `scaffold-crud-feature/02.mapper-read.md`, …). They belong in
+  MANIFEST only. The orchestrator row in Section 6 covers them via
+  indirection — the v2.3.0 validator recognizes this pattern and
+  suppresses MANIFEST_DRIFT for sub-skills under a mentioned
+  orchestrator.
+- Do NOT predict sub-skill names, counts, or ordering. Write
+  "sub-skills registered in MANIFEST" instead of enumerating them.
+
+This single-source-of-truth split (CLAUDE.md §6 = entry; MANIFEST =
+full registry) keeps the two documents independently correct as Pass
+3c iterates on the sub-skill set.
+
 ---
 
 Below is the stack-specific generation guide. Apply these instructions within