cabloy 5.1.191 → 5.1.192

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (82) hide show
  1. package/.cabloy-version +1 -1
  2. package/.github/workflows/agent-governance.yml +39 -0
  3. package/.github/workflows/docs-pages.yml +1 -0
  4. package/.gitignore +3 -0
  5. package/CHANGELOG.md +7 -0
  6. package/package.json +11 -5
  7. package/repo-agent-governance/adapters/claude/contract-loop-gate.ts +199 -0
  8. package/{.claude → repo-agent-governance}/commands/release.md +20 -20
  9. package/repo-agent-governance/managed-assets.json +887 -0
  10. package/repo-agent-governance/manifest.json +56 -0
  11. package/{CLAUDE.md → repo-agent-governance/policies/repository.md} +4 -2
  12. package/repo-agent-governance/scripts/governance.mjs +570 -0
  13. package/repo-agent-governance/scripts/pack-check.mjs +43 -0
  14. package/{.claude → repo-agent-governance}/skills/cabloy-contract-loop/references/contract-loop-map.md +4 -4
  15. package/{.claude → repo-agent-governance}/skills/cabloy-master-detail/SKILL.md +1 -1
  16. package/{.claude → repo-agent-governance}/skills/cabloy-module-removal/SKILL.md +1 -1
  17. package/{.claude → repo-agent-governance}/skills/cabloy-spec-execution/SKILL.md +1 -1
  18. package/{.claude → repo-agent-governance}/skills/cabloy-spec-execution/references/execution-protocol.md +8 -8
  19. package/{.claude → repo-agent-governance}/skills/cabloy-spec-execution/references/status-and-evidence.md +9 -9
  20. package/{.claude → repo-agent-governance}/skills/cabloy-spec-generation/SKILL.md +2 -2
  21. package/{.claude → repo-agent-governance}/skills/cabloy-spec-generation/references/repo-aware-discovery.md +7 -7
  22. package/{.claude → repo-agent-governance}/skills/cabloy-spec-generation/references/repo-specs-document-set.md +30 -30
  23. package/{.claude → repo-agent-governance}/skills/cabloy-spec-generation/references/traceability-and-status-rules.md +9 -9
  24. package/{.claude → repo-agent-governance}/skills/cabloy-workflow/SKILL.md +7 -8
  25. package/{.claude → repo-agent-governance}/skills/cabloy-worktree-environment/SKILL.md +9 -9
  26. package/{.claude → repo-agent-governance}/skills/cabloy-zova-source-reading/SKILL.md +5 -5
  27. package/repo-agent-governance/tests/governance.test.mjs +295 -0
  28. package/repo-agent-governance/tools/contract-loop/check.mjs +71 -0
  29. package/repo-agent-governance/tools/contract-loop/core.mjs +189 -0
  30. package/repo-agent-governance/tools/spec-charts/generate-implementation-charts.mjs +858 -0
  31. package/{.claude/skills/cabloy-spec-generation/scripts → repo-agent-governance/tools/spec-charts}/generate-implementation-charts.test.mjs +95 -20
  32. package/repo-docs/.vitepress/config.mjs +1 -0
  33. package/repo-docs/ai/agent-governance.md +80 -0
  34. package/repo-docs/ai/cli-to-skill-map.md +3 -3
  35. package/repo-docs/ai/docs-skills-rules-mapping.md +27 -26
  36. package/repo-docs/ai/edition-consistency-checklist.md +8 -6
  37. package/repo-docs/ai/future-skill-roadmap.md +2 -2
  38. package/repo-docs/ai/introduction.md +7 -6
  39. package/repo-docs/ai/repo-guidance.md +3 -2
  40. package/repo-docs/ai/rules-and-config.md +23 -15
  41. package/repo-docs/ai/skills.md +7 -7
  42. package/repo-docs/ai/verification.md +2 -1
  43. package/repo-docs/fullstack/contract-loop-playbook.md +1 -1
  44. package/repo-docs/fullstack/quickstart.md +1 -1
  45. package/repo-docs/reference/package-map.md +3 -2
  46. package/repo-docs/reference/repo-scripts.md +17 -2
  47. package/scripts/bootstrapAgentGovernance.mjs +81 -0
  48. package/scripts/init.ts +1 -0
  49. package/scripts/release.ts +15 -0
  50. package/scripts/upgrade.ts +66 -7
  51. package/zova/pnpm-lock.yaml +3 -3
  52. package/.claude/hooks/contract-loop-gate.ts +0 -421
  53. package/.claude/scheduled_tasks.lock +0 -1
  54. package/.claude/skills/cabloy-spec-generation/scripts/generate-implementation-charts.mjs +0 -385
  55. /package/{.claude → repo-agent-governance/adapters/claude}/settings.json +0 -0
  56. /package/{.claude → repo-agent-governance}/skills/cabloy-backend-scaffold/SKILL.md +0 -0
  57. /package/{.claude → repo-agent-governance}/skills/cabloy-backend-scaffold/evals/evals.json +0 -0
  58. /package/{.claude → repo-agent-governance}/skills/cabloy-backend-scaffold/references/backend-thread-map.md +0 -0
  59. /package/{.claude → repo-agent-governance}/skills/cabloy-backend-scaffold/references/follow-up-checklist.md +0 -0
  60. /package/{.claude → repo-agent-governance}/skills/cabloy-contract-loop/SKILL.md +0 -0
  61. /package/{.claude → repo-agent-governance}/skills/cabloy-contract-loop/evals/evals.json +0 -0
  62. /package/{.claude → repo-agent-governance}/skills/cabloy-contract-loop/references/resource-custom-state-pattern.md +0 -0
  63. /package/{.claude → repo-agent-governance}/skills/cabloy-contract-loop/references/verification-checklist.md +0 -0
  64. /package/{.claude → repo-agent-governance}/skills/cabloy-domain-planning/SKILL.md +0 -0
  65. /package/{.claude → repo-agent-governance}/skills/cabloy-frontend-scaffold/SKILL.md +0 -0
  66. /package/{.claude → repo-agent-governance}/skills/cabloy-frontend-scaffold/evals/evals.json +0 -0
  67. /package/{.claude → repo-agent-governance}/skills/cabloy-frontend-scaffold/references/follow-up-checklist.md +0 -0
  68. /package/{.claude → repo-agent-governance}/skills/cabloy-frontend-scaffold/references/frontend-thread-map.md +0 -0
  69. /package/{.claude → repo-agent-governance}/skills/cabloy-resource-field-update/SKILL.md +0 -0
  70. /package/{.claude → repo-agent-governance}/skills/cabloy-resource-field-update/evals/evals.json +0 -0
  71. /package/{.claude → repo-agent-governance}/skills/cabloy-resource-field-update/references/custom-renderer-demo-checklist.md +0 -0
  72. /package/{.claude → repo-agent-governance}/skills/cabloy-resource-field-update/references/field-update-decision-tree.md +0 -0
  73. /package/{.claude → repo-agent-governance}/skills/cabloy-resource-field-update/references/follow-up-checklist.md +0 -0
  74. /package/{.claude → repo-agent-governance}/skills/cabloy-resource-field-update/references/verification-checklist.md +0 -0
  75. /package/{.claude → repo-agent-governance}/skills/cabloy-spec-execution/evals/evals.json +0 -0
  76. /package/{.claude → repo-agent-governance}/skills/cabloy-spec-generation/evals/evals.json +0 -0
  77. /package/{.claude → repo-agent-governance}/skills/cabloy-workflow/evals/evals.json +0 -0
  78. /package/{.claude → repo-agent-governance}/skills/cabloy-workflow/references/cli-strategy.md +0 -0
  79. /package/{.claude → repo-agent-governance}/skills/cabloy-workflow/references/edition-detection.md +0 -0
  80. /package/{.claude → repo-agent-governance}/skills/cabloy-worktree-environment/evals/evals.json +0 -0
  81. /package/{.claude → repo-agent-governance}/skills/cabloy-zova-source-reading/references/analysis-modes.md +0 -0
  82. /package/{.claude → repo-agent-governance}/skills/cabloy-zova-source-reading/references/core-reading-paths.md +0 -0
@@ -98,10 +98,10 @@ One persisted domain may deliberately own both conventional Admin Resource opera
98
98
 
99
99
  After generation, choose the consumer shape by boundary:
100
100
 
101
- | Consumer | Generated-contract follow-up |
102
- | --- | --- |
103
- | Admin custom operation with the same authority, projection, and Resource page semantics | thin module facade → `rest-resource.model.resource` → schema-driven Resource UI |
104
- | Web self-service operation with different authority, server-derived owner scope, DTO projection, or page/SSR semantics | dedicated Web model → purpose-built self-service pages |
101
+ | Consumer | Generated-contract follow-up |
102
+ | ---------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------- |
103
+ | Admin custom operation with the same authority, projection, and Resource page semantics | thin module facade → `rest-resource.model.resource` → schema-driven Resource UI |
104
+ | Web self-service operation with different authority, server-derived owner scope, DTO projection, or page/SSR semantics | dedicated Web model → purpose-built self-service pages |
105
105
 
106
106
  The Web model is valid only for the separate self-service state domain. It must not become a parallel owner for Admin `select`/`view`, schemas, permissions, or generic Resource page state. See `../../../../repo-docs/fullstack/admin-resource-and-web-self-service.md` for the complete architecture.
107
107
 
@@ -207,4 +207,4 @@ When helpful, structure the response around these points:
207
207
  5. nested DTO naming and placement reminders
208
208
  6. verification steps
209
209
 
210
- Keep the response practical. The value of this skill is to route master-detail requests into the correct generator-first workflow while preserving the recursive ownership rules encoded by the current source.
210
+ Keep the response practical. The value of this skill is to route master-detail requests into the correct generator-first workflow while preserving the recursive ownership rules encoded by the current source.
@@ -142,4 +142,4 @@ When using this skill, structure the response around these points when helpful:
142
142
  5. stale-generated-runtime recovery branch if needed
143
143
  6. verification steps
144
144
 
145
- Keep the response practical. The value of this skill is to choose the right removal branch quickly and keep generated working state in the correct role.
145
+ Keep the response practical. The value of this skill is to choose the right removal branch quickly and keep generated working state in the correct role.
@@ -26,7 +26,7 @@ From the active repository root, inspect:
26
26
 
27
27
  1. `git rev-parse --show-toplevel`, `git status --short`, current `HEAD`, and the working-tree classification;
28
28
  2. `__CABLOY_BASIC__` or `__CABLOY_START__`;
29
- 3. root `package.json` and `CLAUDE.md`;
29
+ 3. root `package.json` and `repo-agent-governance/` (or the active generated adapter);
30
30
  4. the target `repo-specs/<suite>/` directory and relevant source/module topology.
31
31
 
32
32
  Interpret the markers as follows:
@@ -13,7 +13,7 @@ git rev-parse HEAD
13
13
  find . -maxdepth 1 \( -name '__CABLOY_BASIC__' -o -name '__CABLOY_START__' \) -print
14
14
  ```
15
15
 
16
- Then inspect the root `package.json`, `CLAUDE.md`, the suite spec directory, and actual affected source paths. Classify the worktree as clean, dirty with unrelated changes, dirty with overlapping changes, or otherwise unknown. Do not clean or reset it to make execution easier.
16
+ Then inspect the root `package.json`, `repo-agent-governance/` (or the active generated adapter), the suite spec directory, and actual affected source paths. Classify the worktree as clean, dirty with unrelated changes, dirty with overlapping changes, or otherwise unknown. Do not clean or reset it to make execution easier.
17
17
 
18
18
  For Basic, resolve current scripts, sites, flavors, UI, and generated paths from the active repository. For Start, inspect the active Start repository and use its own commands and flavor/site names. The shared execution model does not make edition-specific runtime facts interchangeable.
19
19
 
@@ -111,13 +111,13 @@ Require explicit confirmation. If the user changes scope, rebuild the dossier an
111
111
 
112
112
  ## 6. Specialist routing
113
113
 
114
- | Task shape | Primary route | Coordinator must preserve |
115
- | --- | --- | --- |
116
- | Vona module/bean/service/model/entity/DTO/validation/migration/test | `cabloy-backend-scaffold` | CLI-first generation, tenant/security review, migration/index/version gate, tests, OpenAPI impact |
117
- | Zova page/component/route/model/metadata/SSR/test | `cabloy-frontend-scaffold` | route metadata, state ownership, hydration equivalence, emitted import suffixes, flavor/site proof |
118
- | OpenAPI, SDK/schema, generated consumer, reverse metadata, stale consumer | `cabloy-contract-loop` | source-first direction, paired SSR/REST reverse build, `deps:vona`, no hand edits |
119
- | master-detail, resource-field, module removal | corresponding specialist skill | specialized ownership and cleanup order |
120
- | requirement, architecture, scope, identity, or authority change | `cabloy-spec-generation` / `cabloy-domain-planning` | no implementation around unresolved authority |
114
+ | Task shape | Primary route | Coordinator must preserve |
115
+ | ------------------------------------------------------------------------- | --------------------------------------------------- | -------------------------------------------------------------------------------------------------- |
116
+ | Vona module/bean/service/model/entity/DTO/validation/migration/test | `cabloy-backend-scaffold` | CLI-first generation, tenant/security review, migration/index/version gate, tests, OpenAPI impact |
117
+ | Zova page/component/route/model/metadata/SSR/test | `cabloy-frontend-scaffold` | route metadata, state ownership, hydration equivalence, emitted import suffixes, flavor/site proof |
118
+ | OpenAPI, SDK/schema, generated consumer, reverse metadata, stale consumer | `cabloy-contract-loop` | source-first direction, paired SSR/REST reverse build, `deps:vona`, no hand edits |
119
+ | master-detail, resource-field, module removal | corresponding specialist skill | specialized ownership and cleanup order |
120
+ | requirement, architecture, scope, identity, or authority change | `cabloy-spec-generation` / `cabloy-domain-planning` | no implementation around unresolved authority |
121
121
 
122
122
  The coordinator may pass the dossier to the specialist; it should not duplicate the specialist’s detailed command tree.
123
123
 
@@ -54,15 +54,15 @@ Do not create an empty `evidence/` directory, placeholder `EVD-*` record, or fab
54
54
 
55
55
  Use the suite’s canonical status meanings:
56
56
 
57
- | Status | Meaning |
58
- | --- | --- |
59
- | `not-started` | Defined, but implementation or acceptance evidence has not started. |
60
- | `in-progress` | Work or verification has started, but closure checks remain. |
61
- | `implementation-complete` | Source work is reported complete, but required ATP or release evidence is incomplete. |
62
- | `verified` | Applicable WBS checks and ATPs passed, with durable traceable evidence containing revision, environment, exact procedure, result, and redacted artifact location. |
63
- | `blocked` | A dependency, unresolved decision, failed gate, attribution problem, or missing required proof prevents closure. |
64
- | `waived` | A temporary exception has an owner, reason, affected scope, and expiry; expiry becomes a release blocker. |
65
- | `deferred` | Explicitly postponed scope; it is not complete or verified. |
57
+ | Status | Meaning |
58
+ | ------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
59
+ | `not-started` | Defined, but implementation or acceptance evidence has not started. |
60
+ | `in-progress` | Work or verification has started, but closure checks remain. |
61
+ | `implementation-complete` | Source work is reported complete, but required ATP or release evidence is incomplete. |
62
+ | `verified` | Applicable WBS checks and ATPs passed, with durable traceable evidence containing revision, environment, exact procedure, result, and redacted artifact location. |
63
+ | `blocked` | A dependency, unresolved decision, failed gate, attribution problem, or missing required proof prevents closure. |
64
+ | `waived` | A temporary exception has an owner, reason, affected scope, and expiry; expiry becomes a release blocker. |
65
+ | `deferred` | Explicitly postponed scope; it is not complete or verified. |
66
66
 
67
67
  The normal path is:
68
68
 
@@ -28,7 +28,7 @@ From the repository root, inspect:
28
28
 
29
29
  1. `git rev-parse --show-toplevel` and `git status --short`;
30
30
  2. `__CABLOY_BASIC__` and `__CABLOY_START__`;
31
- 3. the root `package.json` and `CLAUDE.md`;
31
+ 3. the root `package.json` and `repo-agent-governance/` (or the active generated adapter);
32
32
  4. existing `repo-specs/` indexes and related suite/module topology;
33
33
  5. `npm run vona` and `npm run zova` when the records will cite implementation commands.
34
34
 
@@ -173,7 +173,7 @@ Optional records remain subordinate to the PRD/SRS/WBS/test-plan authority appro
173
173
 
174
174
  While drafting, preserve these principles and tailor them to confirmed scope:
175
175
 
176
- - `repo-specs/` is the product/business planning home; `repo-docs/` is public and agent-facing framework guidance; `repo-docs-internal/` holds supporting cross-suite maintainer rationale; `.claude/skills/` is workflow behavior; do not assume a particular internal record exists in every edition;
176
+ - `repo-specs/` is the product/business planning home; `repo-docs/` is public and agent-facing framework guidance; `repo-docs-internal/` holds supporting cross-suite maintainer rationale; `repo-agent-governance/skills/` is authored workflow behavior; do not assume a particular internal record exists in every edition;
177
177
  - use suite-first ownership and distinguish new domain modules from reusable framework modules; do not duplicate an existing persistence or identity owner without a stated decision;
178
178
  - treat the active Vona instance as the tenant by default; do not introduce a store, organization, or merchant entity unless the confirmed domain contract requires it;
179
179
  - make identity, tenant scope, authorization, and ownership server-authoritative; menus, routes, browser filters, and UI visibility are not API authorization;
@@ -78,13 +78,13 @@ Hand actual implementation-time synchronization to `cabloy-contract-loop`.
78
78
 
79
79
  ## Documentation boundaries
80
80
 
81
- | Content | Home |
82
- | --- | --- |
83
- | Product requirements, SRS contracts, WBS, ATPs, suite ADRs, delivery status | `repo-specs/<suite>/` |
84
- | Reusable user-facing or agent-facing framework guidance | `repo-docs/` |
85
- | Cross-suite maintainer architecture, rationale, and engineering ADRs | `repo-docs-internal/`; individual records may vary by edition |
86
- | Short durable AI operating rules | `CLAUDE.md` |
87
- | Reusable Claude procedure | `.claude/skills/` |
81
+ | Content | Home |
82
+ | --------------------------------------------------------------------------- | ------------------------------------------------------------- |
83
+ | Product requirements, SRS contracts, WBS, ATPs, suite ADRs, delivery status | `repo-specs/<suite>/` |
84
+ | Reusable user-facing or agent-facing framework guidance | `repo-docs/` |
85
+ | Cross-suite maintainer architecture, rationale, and engineering ADRs | `repo-docs-internal/`; individual records may vary by edition |
86
+ | Short durable AI operating rules | `repo-agent-governance/policies/` |
87
+ | Reusable procedural workflow | `repo-agent-governance/skills/` |
88
88
 
89
89
  Do not place suite product specifications in public docs, or copy repository-wide process rationale into every suite. Link to authoritative framework records instead.
90
90
 
@@ -24,18 +24,18 @@ The directory is repository-native, suite-local, and maintainer-facing. It is no
24
24
 
25
25
  ## Authority map
26
26
 
27
- | Document | Authority |
28
- | --- | --- |
29
- | `README.md` | Index, reading order, baseline summary, topology, authority map, and related-record links. It does not replace the other documents. |
30
- | `prd.md` | Product outcomes, personas, scope, journeys, business rules, product requirements, and product acceptance. |
31
- | `srs.md` | System contracts, capability/data ownership, APIs/DTOs, authorization, state, transactions, invariants, frontend/SSR boundaries, and technical acceptance. |
32
- | `pdp-wbs.md` | Delivery sequencing, dependencies, implementation tasks, completion checks, and delivery traceability. |
33
- | `test-plan.md` | Quality priorities, executable acceptance scenarios, fixtures, evidence format, verification procedures, and release proof. |
34
- | `progress.md` | Derived execution status, blockers, decisions needed, next proof, and evidence pointers. It never redefines requirements or contracts. |
35
- | `implementation-gantt.svg` | Deterministic derived WBS view of phases, task order, dependencies, status, and optional ATP labels. It is not schedule or planning authority. |
36
- | `implementation-burndown.svg` | Deterministic derived scope/status view. Without dated history, it is a scope-count reference, not a time-series, velocity trend, or forecast. |
37
- | `decisions/*.md` | Durable suite-local scope, architecture, security, ownership, migration, or integration decisions. |
38
- | `runbooks/*.md` | Operational procedures subordinate to the relevant SRS, ADR, WBS, and test plan. |
27
+ | Document | Authority |
28
+ | ----------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- |
29
+ | `README.md` | Index, reading order, baseline summary, topology, authority map, and related-record links. It does not replace the other documents. |
30
+ | `prd.md` | Product outcomes, personas, scope, journeys, business rules, product requirements, and product acceptance. |
31
+ | `srs.md` | System contracts, capability/data ownership, APIs/DTOs, authorization, state, transactions, invariants, frontend/SSR boundaries, and technical acceptance. |
32
+ | `pdp-wbs.md` | Delivery sequencing, dependencies, implementation tasks, completion checks, and delivery traceability. |
33
+ | `test-plan.md` | Quality priorities, executable acceptance scenarios, fixtures, evidence format, verification procedures, and release proof. |
34
+ | `progress.md` | Derived execution status, blockers, decisions needed, next proof, and evidence pointers. It never redefines requirements or contracts. |
35
+ | `implementation-gantt.svg` | Deterministic derived WBS view of phases, task order, dependencies, status, and optional ATP labels. It is not schedule or planning authority. |
36
+ | `implementation-burndown.svg` | Deterministic derived scope/status view. Without dated history, it is a scope-count reference, not a time-series, velocity trend, or forecast. |
37
+ | `decisions/*.md` | Durable suite-local scope, architecture, security, ownership, migration, or integration decisions. |
38
+ | `runbooks/*.md` | Operational procedures subordinate to the relevant SRS, ADR, WBS, and test plan. |
39
39
 
40
40
  When records disagree, update the authoritative record first, then update downstream summaries, mappings, and derived status. After any change to `pdp-wbs.md`, `test-plan.md`, or `progress.md`, run `npm run spec:charts -- <suite>` followed by `npm run spec:charts:check -- <suite>`.
41
41
 
@@ -186,15 +186,15 @@ Use:
186
186
 
187
187
  Initialize a new suite with statuses such as `not-started`, `deferred`, or explicitly `blocked`; do not mark planning work as verified. Use this vocabulary:
188
188
 
189
- | Status | Meaning |
190
- | --- | --- |
191
- | `not-started` | Defined, but implementation or acceptance evidence has not started. |
192
- | `in-progress` | Work started, but closure checks are incomplete. |
193
- | `implementation-complete` | Source work is reported complete, but required ATP evidence or release gates are incomplete. |
194
- | `verified` | Required ATP evidence is observed and retained with revision, environment, procedure, result, and redacted artifact location. |
195
- | `blocked` | A dependency, unresolved decision, or failed gate prevents closure. |
196
- | `waived` | A temporary exception with owner, reason, and expiry; expiry makes it a release blocker. |
197
- | `deferred` | Explicitly postponed scope, not completed scope. |
189
+ | Status | Meaning |
190
+ | ------------------------- | ----------------------------------------------------------------------------------------------------------------------------- |
191
+ | `not-started` | Defined, but implementation or acceptance evidence has not started. |
192
+ | `in-progress` | Work started, but closure checks are incomplete. |
193
+ | `implementation-complete` | Source work is reported complete, but required ATP evidence or release gates are incomplete. |
194
+ | `verified` | Required ATP evidence is observed and retained with revision, environment, procedure, result, and redacted artifact location. |
195
+ | `blocked` | A dependency, unresolved decision, or failed gate prevents closure. |
196
+ | `waived` | A temporary exception with owner, reason, and expiry; expiry makes it a release blocker. |
197
+ | `deferred` | Explicitly postponed scope, not completed scope. |
198
198
 
199
199
  Progress must remain a derived register. It may point to evidence but must not become a second requirements document. Include a decision-register entry for each material site strategy and show strategy/identifier deferral as a blocker only on affected frontend/site WBS branches; source reading, planning, or a selected strategy alone is not implementation evidence.
200
200
 
@@ -244,13 +244,13 @@ Use `Accepted` only for explicitly confirmed durable decisions; otherwise use `P
244
244
 
245
245
  Generate only when the confirmed scope requires them:
246
246
 
247
- | Extension | Generate when |
248
- | --- | --- |
249
- | `presentation-contracts.md` | Multiple Admin/resource scenes need stable audience, task, information-area, editability, snapshot, or renderer decisions. Keep it subordinate to PRD/SRS. |
250
- | `semantic-presentation-rollout.md` | Presentation/metadata work is staged, serial, resumable, and needs handoff gates. It does not replace WBS or test plan. |
251
- | `runbooks/<provider-or-operation>.md` | Real external provider/webhook, sandbox/live operation, reconciliation, cutover, incident, or deployment procedure is in scope. Never include secrets. |
252
- | Additional ADRs | A separate durable boundary or trade-off exists after ADR 0001. |
253
- | `evidence/` | Actual ATP execution has produced retained redacted evidence. Do not create empty evidence to simulate progress. |
247
+ | Extension | Generate when |
248
+ | ------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- |
249
+ | `presentation-contracts.md` | Multiple Admin/resource scenes need stable audience, task, information-area, editability, snapshot, or renderer decisions. Keep it subordinate to PRD/SRS. |
250
+ | `semantic-presentation-rollout.md` | Presentation/metadata work is staged, serial, resumable, and needs handoff gates. It does not replace WBS or test plan. |
251
+ | `runbooks/<provider-or-operation>.md` | Real external provider/webhook, sandbox/live operation, reconciliation, cutover, incident, or deployment procedure is in scope. Never include secrets. |
252
+ | Additional ADRs | A separate durable boundary or trade-off exists after ADR 0001. |
253
+ | `evidence/` | Actual ATP execution has produced retained redacted evidence. Do not create empty evidence to simulate progress. |
254
254
 
255
255
  For a presentation matrix, record audience, task, resource/scene, business information areas, field boundaries, renderer choice, and linked PRD/SRS/ATP records. It must not redefine API authority, persistence, validation, authorization, page/state ownership, or SSR privacy.
256
256
 
@@ -260,8 +260,8 @@ For an operational runbook, record environment boundaries, secret-management rul
260
260
 
261
261
  Every core document links to the README and relevant peers. Maintain a compact matrix like:
262
262
 
263
- | Product area | PRD | SRS | WBS | ATP | Evidence/status |
264
- | --- | --- | --- | --- | --- | --- |
263
+ | Product area | PRD | SRS | WBS | ATP | Evidence/status |
264
+ | -------------- | --------- | --------- | --------- | --------- | ----------------------------- |
265
265
  | `<capability>` | `PRD-...` | `SRS-...` | `WBS-...` | `ATP-...` | `progress.md` / evidence link |
266
266
 
267
267
  Every material product requirement needs at least one technical contract, delivery item, and executable acceptance scenario. Before reporting generation complete, statically audit exact-ID referential integrity and README/ADR decision-status consistency across the planning authority set. Exclude `evidence/` from this static audit: evidence is added only after execution.
@@ -64,15 +64,15 @@ Downstream records summarize or operationalize authority; they do not silently o
64
64
 
65
65
  ## Status semantics
66
66
 
67
- | Status | Meaning |
68
- | --- | --- |
69
- | `not-started` | Defined, but implementation or acceptance evidence has not started. |
70
- | `in-progress` | Work or verification has started, but closure checks are incomplete. |
71
- | `implementation-complete` | Source work is reported complete, but required ATP or release evidence is incomplete. |
72
- | `verified` | Applicable WBS checks and ATPs passed, and durable evidence contains revision, environment, exact procedure, result, and redacted artifact location. |
73
- | `blocked` | A failed gate, dependency, or unresolved decision prevents closure. |
74
- | `waived` | A temporary exception explicitly approved with owner, reason, and expiry. |
75
- | `deferred` | Explicitly postponed scope; it is not complete or verified. |
67
+ | Status | Meaning |
68
+ | ------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
69
+ | `not-started` | Defined, but implementation or acceptance evidence has not started. |
70
+ | `in-progress` | Work or verification has started, but closure checks are incomplete. |
71
+ | `implementation-complete` | Source work is reported complete, but required ATP or release evidence is incomplete. |
72
+ | `verified` | Applicable WBS checks and ATPs passed, and durable evidence contains revision, environment, exact procedure, result, and redacted artifact location. |
73
+ | `blocked` | A failed gate, dependency, or unresolved decision prevents closure. |
74
+ | `waived` | A temporary exception explicitly approved with owner, reason, and expiry. |
75
+ | `deferred` | Explicitly postponed scope; it is not complete or verified. |
76
76
 
77
77
  For a newly created plan, initialize delivery rows as `not-started`, `deferred`, or `blocked` as appropriate. Creating Markdown files never makes implementation `implementation-complete` or `verified`.
78
78
 
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: cabloy-workflow
3
- description: This skill should be used when the main Cabloy problem is workflow routing before implementation: deciding between Vona backend scaffolding, Zova frontend scaffolding, contract-loop work, or docs/AI-enablement homes such as repo-docs, repo-docs-internal, CLAUDE.md, commands, or skills, including cases where Cabloy Basic vs Cabloy Start assumptions affect that routing. Trigger on requests to route, classify, choose a workflow, choose an edition-specific path, or decide where Cabloy guidance should live. Do not use it once the task is already clearly a backend scaffold, frontend scaffold, or contract-loop job.
3
+ description: This skill should be used when the main Cabloy problem is workflow routing before implementation: deciding between Vona backend scaffolding, Zova frontend scaffolding, contract-loop work, or docs/AI-enablement homes such as repo-docs, repo-docs-internal, repo-agent-governance, commands, or skills, including cases where Cabloy Basic vs Cabloy Start assumptions affect that routing. Trigger on requests to route, classify, choose a workflow, choose an edition-specific path, or decide where Cabloy guidance should live. Do not use it once the task is already clearly a backend scaffold, frontend scaffold, or contract-loop job.
4
4
  ---
5
5
 
6
6
  # Cabloy Workflow
@@ -79,9 +79,8 @@ Use the docs/AI path when the task is about:
79
79
 
80
80
  - `repo-docs/`
81
81
  - `repo-docs-internal/`
82
- - `CLAUDE.md`
83
- - `.claude/commands/`
84
- - `.claude/skills/`
82
+ - `repo-agent-governance/`
83
+ - generated platform adapters such as `CLAUDE.md`, `.claude/commands/`, and `.claude/skills/`
85
84
  - repo guidance for AI development
86
85
 
87
86
  ## Step 3: Start from shared entrypoints
@@ -91,7 +90,7 @@ Before inventing a workflow, inspect these shared surfaces:
91
90
  - the repository or workspace `package.json` that owns the active scripts
92
91
  - `npm run vona`
93
92
  - `npm run zova`
94
- - root `CLAUDE.md` if present
93
+ - root `repo-agent-governance/` if present, otherwise the active generated adapter
95
94
  - `repo-docs/` for public guidance
96
95
  - `repo-docs-internal/` for supporting maintainer rationale
97
96
 
@@ -179,7 +178,7 @@ Relevant internal records support routing and implementation but do not block th
179
178
 
180
179
  ### Root rules and commands
181
180
 
182
- Use `CLAUDE.md` and `.claude/commands/` for:
181
+ Use `repo-agent-governance/policies/` and `commands/` as the authored source for:
183
182
 
184
183
  - concise operational guidance
185
184
  - named recurring workflows
@@ -187,7 +186,7 @@ Use `CLAUDE.md` and `.claude/commands/` for:
187
186
 
188
187
  ### Skills
189
188
 
190
- Use `.claude/skills/` for:
189
+ Use `repo-agent-governance/skills/` for:
191
190
 
192
191
  - procedural workflows that benefit from reusable instructions
193
192
  - edition-aware decision trees
@@ -208,7 +207,7 @@ For these requests:
208
207
 
209
208
  - put the durable operational explanation in `repo-docs/`
210
209
  - put supporting rationale and invariants in `repo-docs-internal/`; preserve the public operational explanation when a particular internal record is unavailable or irrelevant
211
- - keep `CLAUDE.md` short and behavioral
210
+ - keep canonical repository policy short and behavioral, then render adapters
212
211
  - do not treat `@Service()` as a business-layer naming decision only; for B2 it is a runtime-anchor placement choice
213
212
 
214
213
  ### Service underscore files
@@ -29,10 +29,10 @@ Before proposing configuration values or writing files:
29
29
 
30
30
  Interpretation:
31
31
 
32
- | Marker | Edition | Managed clean E2E command |
33
- | --- | --- | --- |
34
- | `__CABLOY_BASIC__` only | Cabloy Basic | `npm run test:e2e` |
35
- | `__CABLOY_START__` only | Cabloy Start | `npm run test:e2e` |
32
+ | Marker | Edition | Managed clean E2E command |
33
+ | ----------------------- | ------------ | ------------------------- |
34
+ | `__CABLOY_BASIC__` only | Cabloy Basic | `npm run test:e2e` |
35
+ | `__CABLOY_START__` only | Cabloy Start | `npm run test:e2e` |
36
36
 
37
37
  Stop without edits when both markers are present, neither marker is present, the checkout is primary/unregistered, required environment directories are missing, or the selected edition's required scripts are unavailable.
38
38
 
@@ -66,11 +66,11 @@ offset = linkedWorktreeOrdinal + batch
66
66
 
67
67
  Use these fixed baseline ports, which match the committed Cabloy defaults:
68
68
 
69
- | Setting | Baseline | Recommended value |
70
- | --- | ---: | --- |
71
- | `SERVER_LISTEN_PORT` | `7102` | `7102 + offset` |
72
- | `DEV_SERVER_PORT` | `9000` | `9000 + offset` |
73
- | `DEV_SERVER_HMR_PORT` | `24679` | `24679 + offset` |
69
+ | Setting | Baseline | Recommended value |
70
+ | --------------------- | -------: | ----------------- |
71
+ | `SERVER_LISTEN_PORT` | `7102` | `7102 + offset` |
72
+ | `DEV_SERVER_PORT` | `9000` | `9000 + offset` |
73
+ | `DEV_SERVER_HMR_PORT` | `24679` | `24679 + offset` |
74
74
 
75
75
  Set `APP_NAME` to the basename of the validated current worktree root. Do not inspect other worktrees’ configurations or append an env-derived suffix. Stop if that basename is empty or cannot be used as an application name without altering it; ask the user to rename/recreate the linked worktree instead.
76
76
 
@@ -193,11 +193,11 @@ When explaining a split page or component, establish role ownership before discu
193
193
 
194
194
  The source-confirmed direct member lookup order is:
195
195
 
196
- | Current bean | Direct member lookup order |
197
- | --- | --- |
198
- | Controller | Controller only |
199
- | Style | Style, then Controller |
200
- | Render | Render, then Controller, then Style |
196
+ | Current bean | Direct member lookup order |
197
+ | ------------ | ----------------------------------- |
198
+ | Controller | Controller only |
199
+ | Style | Style, then Controller |
200
+ | Render | Render, then Controller, then Style |
201
201
 
202
202
  State the shadowing caveat: an own member on the current bean takes precedence over each fallback surface. Recommend `this.member` for ordinary same-component companion access, such as Render reading Controller state or a Style-generated class.
203
203