jared/cc-os

Watch

Fork 0

crc-refactor skill still places files by role directory (A1); update to A15 #945

New issue

Closed

opened 2026-10-04 20:28:48 +00:00 by jared · 2 comments

jared commented

2026-10-04 20:28:48 +00:00

Owner

Problem

ADR-0273 and Design Lens A15 replace role directories with a domain-first layout. The crc-refactor skill still tells a run to place files by role directory. The next crc-refactor run would place files against the accepted layout.

Reproduce

n/a: design ticket, the skill text is the defect.

Approach

Update plugins/os-sdlc/skills/crc-refactor/SKILL.md and its reference files so that placement follows A15. This covers the ledger role column, the census role flags, the {{ROLE_DIRS}} parameter, and wave 2 placement. Line numbers are in docs/crc/os-adr/lens-challenge-a1.md section "Files that change with the lens", under "crc-refactor".

The reference files are references/standing-rules.md, naming-placement-extraction.md, ledger.md, parameters.md, role-morph-brief.md, prompts/role-morph.md, prompts/implementation.md, and format-exemplar.md.

Required work:

Remove the ROLE_DIRS parameter — check: absent {{ROLE_DIRS}} in plugins/os-sdlc/skills/crc-refactor/**

This ticket must land before the next crc-refactor run.

Acceptance criteria

Given the crc-refactor skill and references, when a run reads them, then no file tells the run to choose a role directory.
Given a file in wave 2, when the run places it, then the concept picks the directory and the path spells the Zeitwerk constant (A15).

Origin

Trigger: the os-adr crc-refactor run, branch crc-os-adr-2026-10-04, and ADR-0273.
Improvised this session: none
Chain: crc-refactor places by role directory ← skill text predates A15 ← DESIGN (ADR-0273, lens A15)
Root candidate: none
Where: plugins/os-sdlc/skills/crc-refactor/SKILL.md
Session: ed701ed0-1700-4d83-93da-30abc0fa9a77
Transcript: /home/jared/.claude/projects/-home-jared-dev-cc-os--claude-worktrees-crc-os-adr-2026-10-04/ed701ed0-1700-4d83-93da-30abc0fa9a77.jsonl

VERDICT: CREATE

## Problem ADR-0273 and Design Lens A15 replace role directories with a domain-first layout. The crc-refactor skill still tells a run to place files by role directory. The next crc-refactor run would place files against the accepted layout. ## Reproduce n/a: design ticket, the skill text is the defect. ## Approach Update `plugins/os-sdlc/skills/crc-refactor/SKILL.md` and its reference files so that placement follows A15. This covers the ledger `role` column, the census role flags, the `{{ROLE_DIRS}}` parameter, and wave 2 placement. Line numbers are in `docs/crc/os-adr/lens-challenge-a1.md` section "Files that change with the lens", under "crc-refactor". The reference files are `references/standing-rules.md`, `naming-placement-extraction.md`, `ledger.md`, `parameters.md`, `role-morph-brief.md`, `prompts/role-morph.md`, `prompts/implementation.md`, and `format-exemplar.md`. Required work: 1. Remove the ROLE_DIRS parameter — check: absent `{{ROLE_DIRS}}` in `plugins/os-sdlc/skills/crc-refactor/**` This ticket must land before the next crc-refactor run. ## Acceptance criteria 1. Given the crc-refactor skill and references, when a run reads them, then no file tells the run to choose a role directory. 2. Given a file in wave 2, when the run places it, then the concept picks the directory and the path spells the Zeitwerk constant (A15). ## Origin - Trigger: the os-adr crc-refactor run, branch crc-os-adr-2026-10-04, and ADR-0273. - Improvised this session: none - Chain: crc-refactor places by role directory ← skill text predates A15 ← DESIGN (ADR-0273, lens A15) - Root candidate: none - Where: plugins/os-sdlc/skills/crc-refactor/SKILL.md - Session: ed701ed0-1700-4d83-93da-30abc0fa9a77 - Transcript: /home/jared/.claude/projects/-home-jared-dev-cc-os--claude-worktrees-crc-os-adr-2026-10-04/ed701ed0-1700-4d83-93da-30abc0fa9a77.jsonl VERDICT: CREATE

jared added the

plugin/os-sdlc

filed-by/agent

labels

2026-10-04 20:28:48 +00:00

jared referenced this issue

2026-10-04 20:28:52 +00:00

Move os-sdlc to the A15 domain-first layout #946

jared referenced this issue

2026-10-04 20:29:13 +00:00

Move os-sdlc to the A15 domain-first layout #946

jared commented

2026-10-05 13:50:54 +00:00

Author

Owner

Starting #945 on branch crc-os-adr-2026-10-04. Difference from ticket text: the ticket lists the ledger role column as changing. Jared ruled R3 = A on 2026-10-05: the A10 inward lint takes layers from the ledger role column (role_by_constant), run in crc passes only. So #945 KEEPS the role column and deletes only {{ROLE_DIRS}} and the role-folder census flags. A15 (ffb59f29) is the placement rule.

jared commented

2026-10-05 13:53:00 +00:00

Author

Owner

Resolution

Done: crc-refactor skill and references place by A15 (concept picks the directory, path spells the constant); {{ROLE_DIRS}} and the role-folder census flags (suffix-role, root-dup, role-echo, multi-role) removed; ledger role column kept per R3 = A (layer for role_by_constant, not a directory)

Evidence: commit 172c798c on crc-os-adr-2026-10-04 (unmerged); grep for {{ROLE_DIRS}} in plugins/os-sdlc/skills/crc-refactor finds nothing; no tests cover the skill templates; bin/refresh-plugins ran

Follow-ups: none

## Resolution **Done:** crc-refactor skill and references place by A15 (concept picks the directory, path spells the constant); {{ROLE_DIRS}} and the role-folder census flags (suffix-role, root-dup, role-echo, multi-role) removed; ledger role column kept per R3 = A (layer for role_by_constant, not a directory) **Evidence:** commit 172c798c on crc-os-adr-2026-10-04 (unmerged); grep for {{ROLE_DIRS}} in plugins/os-sdlc/skills/crc-refactor finds nothing; no tests cover the skill templates; bin/refresh-plugins ran **Follow-ups:** none

jared closed this issue

2026-10-05 13:53:00 +00:00

jared referenced this issue from a commit

2026-10-09 18:43:29 +00:00

refactor(os-sdlc): crc-refactor places by A15, drops ROLE_DIRS (#945)

jared referenced this issue

2026-10-16 16:22:24 +00:00

os-sdlc: audit every lib file for ownership and naming (responsibility audit + ADR-0247 names) #835

jared referenced this issue

2026-10-16 16:22:25 +00:00

Move os-sdlc to the A15 domain-first layout #946