init-workspace-patterns

<init_workspace_patterns>

<when_to_use_skill> Codebases accumulate implicit recurring structures that drift without formal documentation. Extract them into explicit reusable templates so agents and contributors produce consistent code. Requires CODEMAP.md on disk. </when_to_use_skill>

<core_concepts>

• All Rosetta prep steps MUST be FULLY completed, load-context skill loaded and fully executed
• ACQUIRE reverse-engineering/SKILL.md FROM KB — apply "Would we rebuild this?" test: pattern = recurring structure surviving a from-scratch rewrite; one-off = historical accident
• Pattern qualifies only if found in 2+ places
• INDEX.md and CHANGES.md must be possible to grep by md headers (top 3 levels). Must not use tables. Instructions ask to grep files to populate list of those items in context.

</core_concepts>

1. Read CODEMAP.md — scope extraction per module
   • if not enough use shell to list recursively all files with minimal output parameters
   • limit top 10-15 most common patterns
   • limit reading samples to 2-3 files per pattern
   • add 2-3 more patterns as you see fit
2. Dual-mode:
   • CHECK-EXISTS: read docs/PATTERNS/ and INDEX.md
   • IDENTIFY-GAPS: compare existing patterns against codebase
   • CREATE-OR-UPDATE: install = create all; upgrade = add missing only
   • PRESERVE-HUMAN: never overwrite human-curated content
   • REPORT-CHANGES: log to CHANGES.md
3. Per pattern file (docs/PATTERNS/*.md):
   • Name: short identifier (e.g., "REST Controller Endpoint")
   • Description: what it solves, when to use
   • Template/Example: generalizable code skeleton with extension-point comments
4. Write docs/PATTERNS/INDEX.md — all patterns with one-line descriptions, one header per each pattern ## Pattern Name - short description
5. Write docs/PATTERNS/CHANGES.md — created/updated/skipped, one header per each change ## [YYYY-MM-DD] Brief changes made
6. If state.composite = true, extract per sub-repository; top-level INDEX.md references sub-repo folders

<validation_checklist>

• Every pattern represents a genuinely recurring structure (2+ occurrences)
• INDEX.md lists all pattern files
• CHANGES.md tracks all actions taken
• No human-curated content overwritten in upgrade mode </validation_checklist>

</init_workspace_patterns>