This repository was archived by the owner on May 21, 2026. It is now read-only.
S260224-01: concept governance + YAML unification run/ship closure #26
There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,157 @@ | ||
| version: 1 | ||
| generated_at_utc: "2026-02-24T00:30:16Z" | ||
| mode: advisory | ||
| source: | ||
| git_tracked_only: true | ||
| scope: | ||
| include_globs: | ||
| - "**/*" | ||
| exclude_globs: | ||
| - ".git/**" | ||
| - ".cwf/**" | ||
| - "node_modules/**" | ||
| - "dist/**" | ||
| - "build/**" | ||
| - "coverage/**" | ||
| - ".venv/**" | ||
| - "venv/**" | ||
| - "**/*.md" | ||
| - "**/*.mdx" | ||
| - "**/*.png" | ||
| - "**/*.jpg" | ||
| - "**/*.jpeg" | ||
| - "**/*.gif" | ||
| - "**/*.svg" | ||
| - "**/*.pdf" | ||
| - "**/*.lock" | ||
| - "**/package-lock.json" | ||
| - "**/pnpm-lock.yaml" | ||
| - "**/yarn.lock" | ||
| - "**/bun.lock" | ||
| - "**/bun.lockb" | ||
| - "**/*.snap" | ||
| - "**/*.min.js" | ||
| - "**/*.min.css" | ||
| include_extensions: | ||
| - ".sh" | ||
| - ".bash" | ||
| - ".zsh" | ||
| - ".py" | ||
| - ".js" | ||
| - ".jsx" | ||
| - ".ts" | ||
| - ".tsx" | ||
| - ".mjs" | ||
| - ".cjs" | ||
| - ".java" | ||
| - ".go" | ||
| - ".rs" | ||
| - ".rb" | ||
| - ".php" | ||
| - ".cs" | ||
| - ".kt" | ||
| - ".swift" | ||
| - ".scala" | ||
| - ".lua" | ||
| - ".sql" | ||
| - ".yaml" | ||
| - ".yml" | ||
| - ".json" | ||
| - ".toml" | ||
| - ".ini" | ||
| - ".cfg" | ||
| - ".conf" | ||
| - ".xml" | ||
| checks: | ||
| large_file_lines: | ||
| enabled: true | ||
| warn_at: 600 | ||
| error_at: 800 | ||
| long_line_length: | ||
| enabled: true | ||
| warn_at: 140 | ||
| todo_markers: | ||
| enabled: true | ||
| patterns: | ||
| - TODO | ||
| - FIXME | ||
| - HACK | ||
| - XXX | ||
| shell_strict_mode: | ||
| enabled: true | ||
| exclude_globs: [] | ||
| require_contract_and_pragma: true | ||
| pragma_prefix: "cwf: shell-strict-mode relax" | ||
| pragma_required_fields: | ||
| - reason | ||
| - ticket | ||
| - expires | ||
| file_overrides: | ||
| plugins/cwf/hooks/scripts/cwf-hook-gate.sh: | ||
| action: relax | ||
| reason: "Sourced gate library; strict mode must remain at caller entrypoint" | ||
| ticket: CWF-STRICT-RELAX-001 | ||
| expires: "2026-12-31" | ||
| plugins/cwf/hooks/scripts/env-loader.sh: | ||
| action: relax | ||
| reason: "Sourced env loader shared by multiple scripts" | ||
| ticket: CWF-STRICT-RELAX-002 | ||
| expires: "2026-12-31" | ||
| plugins/cwf/hooks/scripts/slack-send.sh: | ||
| action: relax | ||
| reason: "Primarily sourced helper; strict mode controlled by caller" | ||
| ticket: CWF-STRICT-RELAX-003 | ||
| expires: "2026-12-31" | ||
| plugins/cwf/hooks/scripts/text-format.sh: | ||
| action: relax | ||
| reason: "Sourced formatting helper used from strict and non-strict callers" | ||
| ticket: CWF-STRICT-RELAX-004 | ||
| expires: "2026-12-31" | ||
| deep_review: | ||
| enabled: true | ||
| fixed_experts: | ||
| - name: Martin Fowler | ||
| domain: "refactoring patterns, knowledge duplication (Rule of Three), shared abstractions, evolutionary design" | ||
| source: "Refactoring (2nd ed., 2018), BeckDesignRules (martinfowler.com/bliki)" | ||
| - name: Kent Beck | ||
| domain: "Tidy First, small safe refactorings, test-driven development, simple design" | ||
| source: "Tidy First? (2023), Test-Driven Development: By Example (2002), Extreme Programming Explained (2004)" | ||
| context_experts: | ||
| - name: Nancy Leveson | ||
| domain: "systems safety engineering, STAMP/STPA, control-structure analysis" | ||
| source: "Engineering a Safer World (MIT Press, 2011)" | ||
| - name: Donella Meadows | ||
| domain: "systems thinking, feedback loops, leverage points" | ||
| source: "Thinking in Systems (2008)" | ||
| - name: David Parnas | ||
| domain: "information hiding, modular decomposition criteria" | ||
| source: "On the Criteria To Be Used in Decomposing Systems into Modules (CACM, 1972)" | ||
| - name: John Ousterhout | ||
| domain: "deep modules, interface simplicity, strategic design" | ||
| source: "A Philosophy of Software Design (2018/2021)" | ||
| context_expert_count: 2 | ||
| selection_keywords: | ||
| large_file_lines: | ||
| - modular | ||
| - decomposition | ||
| - architecture | ||
| - design | ||
| long_line_length: | ||
| - readability | ||
| - clarity | ||
| - maintainability | ||
| todo_markers: | ||
| - technical debt | ||
| - process | ||
| - improvement | ||
| shell_strict_mode: | ||
| - safety | ||
| - risk | ||
| - reliability | ||
| - resilience | ||
| reporting: | ||
| top_findings_limit: 30 | ||
| include_clean_summary: true | ||
| notes: | ||
| - "Auto-generated by refactor codebase contract bootstrap." | ||
| - "Tune scope and thresholds for your repository before enforcing as policy." |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,44 @@ | ||
| ## Requirement Clarification Summary | ||
|
|
||
| ### Before (Original) | ||
| "Run `cwf:run` for `.cwf/projects/260224-01-concept-governance-yaml-unification/plan.md`, treat it as a draft, start from gather, continue through the pipeline, and actively request user decisions when needed." | ||
|
|
||
| ### After (Clarified) | ||
| **Goal**: Execute a full CWF run for the concept-governance + YAML-unification migration, using the previous-session draft as seed input and producing an implementation-ready execution contract plus code changes in this branch. | ||
|
|
||
| **Reason**: Turn concept-driven architecture from implicit documentation into deterministic, gate-enforced runtime behavior with YAML-only contract governance. | ||
|
|
||
| **Scope**: | ||
| - Included: | ||
| - Use existing draft as `initial-plan.md` | ||
| - Run gather -> clarify -> plan -> review(plan) -> impl -> review(code) -> refactor -> retro -> ship workflow intent | ||
| - Implement concept-governance scaffolding and YAML contract migration in repo code/docs | ||
| - Update run/review/refactor-related deterministic gates as required by migrated contracts | ||
| - Update `README.md` and `README.ko.md` before release | ||
| - Excluded: | ||
| - Backward-compatibility shims for external consumers | ||
| - Maintaining legacy JSON contract artifacts after migration completion | ||
|
|
||
| **Constraints**: | ||
| - Breaking change is acceptable (`1.0.0` target remains valid). | ||
| - `refactor --codebase --deep` fixed experts must remain mandatory. | ||
| - Deterministic gates are authoritative (no prose-only bypass). | ||
| - User-created files must not be deleted without explicit confirmation. | ||
|
|
||
| **Success Criteria**: | ||
| - Every active skill/hook is bound to >=1 concept or explicitly excluded with owner/reason. | ||
| - Contract governance is YAML-only at end-state; no active `*contract*.json` remains. | ||
| - Expert policy/roster/state split is explicit and operationally enforced. | ||
| - Release docs reflect the migrated architecture without stale legacy guidance. | ||
|
|
||
| ### Decisions Made | ||
|
|
||
| | Question | Decision | | ||
| |---|---| | ||
| | How to treat the previous `plan.md`? | Preserve as `initial-plan.md`; regenerate `plan.md` during run planning stage. | | ||
| | Concept source of truth model | Add machine-readable registry under `plugins/cwf/concepts/registry.yaml`; keep `references/concept-map.md` as explanatory reference, not gate SSOT. | | ||
| | Migration execution style | Execute in phased cutover within one branch/run (skeleton -> concept artifacts -> contract/expert migration -> binding/wiring -> release updates). | | ||
| | Gate rollout order | Build concept gate early, switch to fail-closed enforcement after bindings and references are in place. | | ||
| | Expert policy split direction | Introduce `.cwf/expert-contract.yaml` + `.cwf/expert-roster.yaml`; keep runtime-only fields in `.cwf/cwf-state.yaml`. | | ||
| | Scope for this run | Continue full pipeline intent, raising user decisions only when a blocking architecture fork appears. | | ||
|
|
Oops, something went wrong.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
머신별 절대 경로가 저장소에 커밋됩니다
worktree_root: "/home/hwidong/codes/claude-plugins"은 특정 개발자 환경의 절대 경로입니다.phase: "done"상태이므로 다음 세션의cwf:run실행 시 덮어쓰이겠지만, 현재 커밋에는 개발 환경 정보가 노출되어 있습니다.CWF 도구가 세션 종료 후 이 필드를 자동으로 비우거나 상대 경로로 기록하는 정책을 추가하는 것을 권장합니다.
🤖 Prompt for AI Agents