@blxzer/pactile 0.5.0 → 0.6.0-beta.2

package/dist/templates/markdown/framework/verification-strength-guide.md.txt

@@ -1,185 +1,185 @@
-# Verification Strength Guide
-
-> **Purpose**: Define **how deeply** pactile tasks must be verified before closeout — graded by task risk (Lite / Full / Parent), **not** TDD ceremony.
-
----
-
-## 1. Non-goals
-
-- **No TDD productization** — pactile does not require red-green-refactor loops, "write tests first" gates, or per-function unit test mandates.
-- **No per-task full-suite burden** — Lite tasks must not be forced through architecture review or whole-repo CI.
-- **No replacement for project test frameworks** — pactile validation checks **task evidence** in `verify.md` and configured quality gates; it does not run or replace your project's test runner.
-- **No test-writing mandate** — how to write good tests (pre-agreed seams, anti-patterns, mock boundaries) lives in the [Test Discipline Guide](.pactile/spec/guides/test-discipline-guide.md); verification strength is orthogonal to test-writing style.
-
----
-
-## 2. Two-axis model (verification strength, not TDD)
-
-### Axis A — Task Ladder closeout profile
-
-Inferred by `task.py` from artifact presence and `task.json` meta. Determines **minimum evidence** before archive or child integration.
-
-| Closeout profile | Trigger (existing logic) | Minimum verification depth |
-| --- | --- | --- |
-| **lite** | No `design.md`+`implement.md`; or meta marks lite | PRD AC mapping + focused validation + acceptance + durable-learning decision |
-| **full** | Has `design.md` + `implement.md` | Lite depth + DSC validation + **check evidence** + **reviewed change-set** + configured reviewer gates |
-| **parent** | `task.json.children` non-empty | Each child integrated/cancelled + parent integration evidence + integration-review gate |
-
-**High-risk upgrade (normative):** scope touching framework semantics, cross-file workflow, `verification_profile`, or capabilities should **Lite → Full** per `workflow.md` Task Ladder rules.
-
-### Axis B — `verification_profile` (reviewer gate strictness)
-
-Declared in `implement.md` Development Strategy Contract. Guide narrative: **验证强度** — never "TDD tier".
-
-| Profile | Default enabled gates | Strength meaning |
-| --- | --- | --- |
-| **standard** | requirements-review, code-review | Default Full/Child: planning artifacts + change review + validation/check evidence |
-| **strict** | same as standard (reserved for stricter archive signals) | High-risk Full default this wave |
-| **architecture** | + architecture-review | Cross-layer / contract / template / runtime changes |
-
-Details: `task_gates.py` → `PROFILE_DEFAULT_GATES`.
-
----
-
-## 3. Minimum validation checklist by closeout profile
-
-### Lite
-
-- [ ] Focused validation on **touched behavior** (command + result in `verify.md`)
-- [ ] `python ./.pactile/scripts/task.py validate <task>`
-- [ ] Final acceptance mapped to PRD AC
-- [ ] Durable-learning decision line (see [Durable Learning Decision Guide](.pactile/spec/guides/durable-learning-decision-guide.md))
-
-**Example `verify.md` lines:**
-
-```markdown
-Validation: `python -m py_compile src/foo.py` — exit 0
-Acceptance: prd AC 1–3 satisfied; typo fix verified in editor
-Durable learning decision: no durable learning — one-off content fix
-```
-
-### Full
-
-All Lite items, plus:
-
-- [ ] Validation commands from `implement.md` executed; results recorded
-- [ ] `Check evidence:` or `pactile-check evidence:` — inline skill or agent review completed
-- [ ] `Reviewed change-set:` or `Git diff ref:` — identity of reviewed diff
-- [ ] Required gates recorded via `task.py record-gate` when contract enables them
-
-**Example:**
-
-```markdown
-Validation: probe matrix 4/4 PASS (see research/probe-results.md)
-Check evidence: pactile-check skill — spec compliance + py_compile
-Reviewed change-set: git diff main..HEAD — 8 files in .pactile/spec + scripts
-Acceptance: prd AC 1–5 mapped below
-Durable learning decision: no durable learning
-```
-
-### Parent
-
-All structural children `integrated` or `cancelled`, plus:
-
-- [ ] `Integration evidence:` in parent `verify.md`
-- [ ] `integration-review` gate when parent contract requires it
-
----
-
-## 4. Choosing `verification_profile`
-
-| Situation | Suggested profile |
-| --- | --- |
-| Single-file / local fix, Lite ladder | N/A (lite closeout; gates minimal) |
-| Full task, normal feature | `standard` |
-| High-risk Full (hooks, gates, templates, runtime) | `strict` or `architecture` |
-| Cross-layer contract / framework semantics | `architecture` |
-
-Set in `implement.md`:
-
-```yaml
-verification_profile: standard
-quality_gates:
-  mode: explicit
-  enabled: [requirements-review, code-review]
-```
-
----
-
-## 5. `verify.md` signal line format (CLI-aligned)
-
-The CLI uses regex to detect **substantive** evidence. Placeholder values (`TBD`, `N/A`, `待定`, `-`, `...`) are rejected.
-
-| Signal | Example lines (any one match) |
-| --- | --- |
-| Validation | `Validation:`, `Validation commands:`, `Validation results:` |
-| Check evidence | `Check evidence:`, `pactile-check evidence:` |
-| Acceptance | `Acceptance:`, `Final acceptance:`, `Accepted by user:` |
-| Durable learning | `Durable learning decision:`, `no durable learning`, `Spec update evidence:` |
-| Integration | `Integration evidence:`, `Final integration:` |
-| Reviewed change-set | `Reviewed change-set:`, `Git diff ref:`, `Changeset:` |
-
-**Not sufficient alone:**
-
-- `python ./.pactile/scripts/task.py validate` passing JSONL schema — **does not** prove task acceptance
-- Long log dumps without structured signal lines
-- Checkbox ticks in PRD without `verify.md` validation mapping
-
----
-
-## 6. False-green detection
-
-### Existing CLI guards
-
-| Failure mode | Mechanism |
-| --- | --- |
-| Placeholder validation | `PLACEHOLDER_VALUES_RE` in `task_gates.py` |
-| Missing archive signals | `verify_evidence_status()` at archive / `record-gate` |
-| PRD AC all placeholder | `_prd_requirements_review_errors` at start-execution |
-| Gate PASS without evidence | `record-gate` rejects substantive-missing verify |
-
-### Repeatable probe
-
-Run fixture matrix against shared logic (no second rule set):
-
-```powershell
-python ./.pactile/scripts/verify_evidence_probe.py --fixture <path> --profile lite|full|parent --expect pass|fail
-```
-
-Fixtures: `.pactile/tasks/08-06-pactile-p0-verify-capability/research/verification-probes/`
-
-| Fixture | Intent | lite | full |
-| --- | --- | --- | --- |
-| `shallow-placeholder.md` | Placeholder-only verify | FAIL | FAIL |
-| `lite-sufficient.md` | Minimal valid Lite | PASS | FAIL (missing check + changeset) |
-| `full-sufficient.md` | Valid Full closeout | PASS | PASS |
-| `overkill-noise.md` | Verbose logs, no signals | FAIL | FAIL |
-
----
-
-## 7. Shallow vs overkill (quick reference)
-
-| Scenario | Too shallow (should block) | Overkill (non-goal) |
-| --- | --- | --- |
-| Lite typo fix | "Looks good" with no `Validation:` line | architecture-review + full-repo test suite |
-| Full hook change | `py_compile` only, no `Reviewed change-set:` | Mandate new unit test per function (TDD) |
-| Parent integrate child | Child verify still placeholder | Full E2E per child |
-
----
-
-## 8. Integration with pactile-check / record-gate / archive
-
-```text
-Phase 2 Execute → pactile-check (skill/agent) → verify.md evidence
-Phase 3.1 Verify → record-gate (non-baseline) → archive --check
-```
-
-- **pactile-check**: review against spec + task artifacts; fix in-contract defects; write human-readable evidence **before** `record-gate`.
-- **record-gate**: machine state only; requires substantive `verify.md` for PASS/SKIPPED.
-- **archive**: `verify_evidence_status()` must pass for profile; Full also needs gate readiness.
-
-Workflow cross-ref: Phase 3.1 Quality verification in `workflow.md`.
-
----
-
-**Core principle:** Match verification **strength** to task **risk** — enough to catch false greens, never enough to become TDD theater.
+# Verification Strength Guide
+
+> **Purpose**: Define **how deeply** pactile tasks must be verified before closeout — graded by task risk (Lite / Full / Parent), **not** TDD ceremony.
+
+---
+
+## 1. Non-goals
+
+- **No TDD productization** — pactile does not require red-green-refactor loops, "write tests first" gates, or per-function unit test mandates.
+- **No per-task full-suite burden** — Lite tasks must not be forced through architecture review or whole-repo CI.
+- **No replacement for project test frameworks** — pactile validation checks **task evidence** in `verify.md` and configured quality gates; it does not run or replace your project's test runner.
+- **No test-writing mandate** — how to write good tests (pre-agreed seams, anti-patterns, mock boundaries) lives in the [Test Discipline Guide](.pactile/spec/guides/test-discipline-guide.md); verification strength is orthogonal to test-writing style.
+
+---
+
+## 2. Two-axis model (verification strength, not TDD)
+
+### Axis A — Task Ladder closeout profile
+
+Inferred by `pactile task` from artifact presence and `task.json` meta. Determines **minimum evidence** before archive or child integration.
+
+| Closeout profile | Trigger (existing logic) | Minimum verification depth |
+| --- | --- | --- |
+| **lite** | No `design.md`+`implement.md`; or meta marks lite | PRD AC mapping + focused validation + acceptance + durable-learning decision |
+| **full** | Has `design.md` + `implement.md` | Lite depth + DSC validation + **check evidence** + **reviewed change-set** + configured reviewer gates |
+| **parent** | `task.json.children` non-empty | Each child integrated/cancelled + parent integration evidence + integration-review gate |
+
+**High-risk upgrade (normative):** scope touching framework semantics, cross-file workflow, `verification_profile`, or capabilities should **Lite → Full** per `workflow.md` Task Ladder rules.
+
+### Axis B — `verification_profile` (reviewer gate strictness)
+
+Declared in `implement.md` Development Strategy Contract. Guide narrative: **验证强度** — never "TDD tier".
+
+| Profile | Default enabled gates | Strength meaning |
+| --- | --- | --- |
+| **standard** | requirements-review, code-review | Default Full/Child: planning artifacts + change review + validation/check evidence |
+| **strict** | same as standard (reserved for stricter archive signals) | High-risk Full default this wave |
+| **architecture** | + architecture-review | Cross-layer / contract / template / runtime changes |
+
+Details: Pactile CLI task guards and the Kernel's persisted controls.
+
+---
+
+## 3. Minimum validation checklist by closeout profile
+
+### Lite
+
+- [ ] Focused validation on **touched behavior** (command + result in `verify.md`)
+- [ ] `pactile task validate <task>`
+- [ ] Final acceptance mapped to PRD AC
+- [ ] Durable-learning decision line (see [Durable Learning Decision Guide](.pactile/spec/guides/durable-learning-decision-guide.md))
+
+**Example `verify.md` lines:**
+
+```markdown
+Validation: `node --check src/foo.mjs` — exit 0
+Acceptance: prd AC 1–3 satisfied; typo fix verified in editor
+Durable learning decision: no durable learning — one-off content fix
+```
+
+### Full
+
+All Lite items, plus:
+
+- [ ] Validation commands from `implement.md` executed; results recorded
+- [ ] `Check evidence:` or `pactile-check evidence:` — inline skill or agent review completed
+- [ ] `Reviewed change-set:` or `Git diff ref:` — identity of reviewed diff
+- [ ] Required gates recorded via `pactile task record-gate` when contract enables them
+
+**Example:**
+
+```markdown
+Validation: probe matrix 4/4 PASS (see research/probe-results.md)
+Check evidence: pactile-check skill — spec compliance + py_compile
+Reviewed change-set: git diff main..HEAD — 8 files in .pactile/spec + scripts
+Acceptance: prd AC 1–5 mapped below
+Durable learning decision: no durable learning
+```
+
+### Parent
+
+All structural children `integrated` or `cancelled`, plus:
+
+- [ ] `Integration evidence:` in parent `verify.md`
+- [ ] `integration-review` gate when parent contract requires it
+
+---
+
+## 4. Choosing `verification_profile`
+
+| Situation | Suggested profile |
+| --- | --- |
+| Single-file / local fix, Lite ladder | N/A (lite closeout; gates minimal) |
+| Full task, normal feature | `standard` |
+| High-risk Full (hooks, gates, templates, runtime) | `strict` or `architecture` |
+| Cross-layer contract / framework semantics | `architecture` |
+
+Set in `implement.md`:
+
+```yaml
+verification_profile: standard
+quality_gates:
+  mode: explicit
+  enabled: [requirements-review, code-review]
+```
+
+---
+
+## 5. `verify.md` signal line format (CLI-aligned)
+
+The CLI uses regex to detect **substantive** evidence. Placeholder values (`TBD`, `N/A`, `待定`, `-`, `...`) are rejected.
+
+| Signal | Example lines (any one match) |
+| --- | --- |
+| Validation | `Validation:`, `Validation commands:`, `Validation results:` |
+| Check evidence | `Check evidence:`, `pactile-check evidence:` |
+| Acceptance | `Acceptance:`, `Final acceptance:`, `Accepted by user:` |
+| Durable learning | `Durable learning decision:`, `no durable learning`, `Spec update evidence:` |
+| Integration | `Integration evidence:`, `Final integration:` |
+| Reviewed change-set | `Reviewed change-set:`, `Git diff ref:`, `Changeset:` |
+
+**Not sufficient alone:**
+
+- `pactile task validate` passing JSONL schema — **does not** prove task acceptance
+- Long log dumps without structured signal lines
+- Checkbox ticks in PRD without `verify.md` validation mapping
+
+---
+
+## 6. False-green detection
+
+### Existing CLI guards
+
+| Failure mode | Mechanism |
+| --- | --- |
+| Placeholder validation | Pactile CLI task guards |
+| Missing archive signals | `pactile task archive --check` |
+| PRD AC all placeholder | `pactile task start-execution --check` |
+| Gate PASS without evidence | Reviewer gate validation |
+
+### Repeatable probe
+
+Run fixture matrix against shared logic (no second rule set):
+
+```powershell
+pactile task archive <task> --check
+```
+
+For fixtures, create isolated task directories and assert the CLI's reported result and the unchanged task state after `--check`.
+
+| Fixture | Intent | lite | full |
+| --- | --- | --- | --- |
+| `shallow-placeholder.md` | Placeholder-only verify | FAIL | FAIL |
+| `lite-sufficient.md` | Minimal valid Lite | PASS | FAIL (missing check + changeset) |
+| `full-sufficient.md` | Valid Full closeout | PASS | PASS |
+| `overkill-noise.md` | Verbose logs, no signals | FAIL | FAIL |
+
+---
+
+## 7. Shallow vs overkill (quick reference)
+
+| Scenario | Too shallow (should block) | Overkill (non-goal) |
+| --- | --- | --- |
+| Lite typo fix | "Looks good" with no `Validation:` line | architecture-review + full-repo test suite |
+| Full hook change | `py_compile` only, no `Reviewed change-set:` | Mandate new unit test per function (TDD) |
+| Parent integrate child | Child verify still placeholder | Full E2E per child |
+
+---
+
+## 8. Integration with pactile-check / record-gate / archive
+
+```text
+Phase 2 Execute → pactile-check (skill/agent) → verify.md evidence
+Phase 3.1 Verify → record-gate (non-baseline) → archive --check
+```
+
+- **pactile-check**: review against spec + task artifacts; fix in-contract defects; write human-readable evidence **before** `record-gate`.
+- **record-gate**: machine state only; requires substantive `verify.md` for PASS/SKIPPED.
+- **archive**: `verify_evidence_status()` must pass for profile; Full also needs gate readiness.
+
+Workflow cross-ref: Phase 3.1 Quality verification in `workflow.md`.
+
+---
+
+**Core principle:** Match verification **strength** to task **risk** — enough to catch false greens, never enough to become TDD theater.

package/dist/templates/markdown/gitignore.txt

@@ -1,15 +1,15 @@
-# Pactile workflow gitignore
-# Runtime files that should not be committed
-
-# Developer identity (local to each developer)
-.developer
-
-# Current task pointer (local state)
-.current-task
-
-# Session/window scoped runtime state
-.runtime/
-
-# Agent runtime files (in worktree)
-.agent-log
-.session-id
+# Pactile workflow gitignore
+# Runtime files that should not be committed
+
+# Developer identity (local to each developer)
+.developer
+
+# Current task pointer (local state)
+.current-task
+
+# Session/window scoped runtime state
+.runtime/
+
+# Agent runtime files (in worktree)
+.agent-log
+.session-id

package/dist/templates/markdown/index.d.ts

@@ -32,16 +32,12 @@ export declare const guidesE2eWalkthroughGuideContent: string;
 export declare const guidesCrossPlatformThinkingGuideContent: string;
 export declare const frameworkIndexContent: string;
 export declare const frameworkRetrievalDailyGuideContent: string;
-export declare const frameworkCursorSemanticComplianceContent: string;
-export declare const frameworkCursorSubagentPolicyContent: string;
+export declare const frameworkCodexWorkerDispatchContent: string;
 export declare const frameworkExecutionStrategyContent: string;
-export declare const frameworkCursorContextInjectionGuideContent: string;
-export declare const frameworkCursorNativeModesGuideContent: string;
 export declare const frameworkVerificationStrengthGuideContent: string;
 export declare const frameworkInjectionBudgetGuideContent: string;
 export declare const frameworkArtifactLocaleGuideContent: string;
 export declare const frameworkPrdGrillFrontierGuideContent: string;
-export declare const frameworkInternalSkillsReachabilityGuideContent: string;
 export declare const frameworkDogfoodOnlySurfacesGuideContent: string;
 export declare const frameworkParallelFirstExecutionContent: string;
 export declare const frameworkMiddlewareProtocolContent: string;

package/dist/templates/markdown/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/templates/markdown/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAqBH,eAAO,MAAM,eAAe,EAAE,MAAuC,CAAC;AAGtE,eAAO,MAAM,qBAAqB,EAAE,MACK,CAAC;AAG1C,eAAO,MAAM,yBAAyB,QAAwB,CAAC;AAG/D,eAAO,MAAM,wBAAwB,EAAE,MACH,CAAC;AAQrC,eAAO,MAAM,mBAAmB,EAAE,MAEjC,CAAC;AACF,eAAO,MAAM,gCAAgC,EAAE,MAE9C,CAAC;AACF,eAAO,MAAM,gCAAgC,EAAE,MAE9C,CAAC;AACF,eAAO,MAAM,+BAA+B,EAAE,MAE7C,CAAC;AACF,eAAO,MAAM,+BAA+B,EAAE,MAE7C,CAAC;AACF,eAAO,MAAM,2BAA2B,EAAE,MAEzC,CAAC;AAGF,eAAO,MAAM,oBAAoB,EAAE,MAElC,CAAC;AACF,eAAO,MAAM,iCAAiC,EAAE,MAE/C,CAAC;AACF,eAAO,MAAM,yBAAyB,EAAE,MAEvC,CAAC;AACF,eAAO,MAAM,6BAA6B,EAAE,MAE3C,CAAC;AACF,eAAO,MAAM,kCAAkC,EAAE,MAEhD,CAAC;AACF,eAAO,MAAM,gCAAgC,EAAE,MAE9C,CAAC;AACF,eAAO,MAAM,8BAA8B,EAAE,MAE5C,CAAC;AAGF,eAAO,MAAM,kBAAkB,EAAE,MAEhC,CAAC;AACF,eAAO,MAAM,oCAAoC,EAAE,MAElD,CAAC;AACF,eAAO,MAAM,mCAAmC,EAAE,MAEjD,CAAC;AACF,eAAO,MAAM,yCAAyC,EAAE,MACiB,CAAC;AAC1E,eAAO,MAAM,2BAA2B,EAAE,MAEzC,CAAC;AACF,eAAO,MAAM,2BAA2B,EAAE,MAEzC,CAAC;AACF,eAAO,MAAM,gCAAgC,EAAE,MAE9C,CAAC;AACF,eAAO,MAAM,gCAAgC,EAAE,MAE9C,CAAC;AACF,eAAO,MAAM,uCAAuC,EAAE,MACiB,CAAC;AAMxE,eAAO,MAAM,qBAAqB,EAAE,MAEnC,CAAC;AACF,eAAO,MAAM,mCAAmC,EAAE,MAEjD,CAAC;AACF,eAAO,MAAM,wCAAwC,EAAE,MACW,CAAC;AACnE,eAAO,MAAM,oCAAoC,EAAE,MAElD,CAAC;AACF,eAAO,MAAM,iCAAiC,EAAE,MAE/C,CAAC;AACF,eAAO,MAAM,2CAA2C,EAAE,MACY,CAAC;AACvE,eAAO,MAAM,sCAAsC,EAAE,MAEpD,CAAC;AACF,eAAO,MAAM,yCAAyC,EAAE,MACW,CAAC;AACpE,eAAO,MAAM,oCAAoC,EAAE,MAElD,CAAC;AACF,eAAO,MAAM,mCAAmC,EAAE,MAEjD,CAAC;AACF,eAAO,MAAM,qCAAqC,EAAE,MAEnD,CAAC;AACF,eAAO,MAAM,+CAA+C,EAAE,MACa,CAAC;AAC5E,eAAO,MAAM,wCAAwC,EAAE,MACM,CAAC;AAC9D,eAAO,MAAM,sCAAsC,EAAE,MAEpD,CAAC;AACF,eAAO,MAAM,kCAAkC,EAAE,MAEhD,CAAC;AACF,eAAO,MAAM,uBAAuB,EAAE,MAErC,CAAC;AACF,eAAO,MAAM,+BAA+B,EAAE,MAE7C,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,aAAa,EAAE,SAAS;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB,EA4DA,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/templates/markdown/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAqBH,eAAO,MAAM,eAAe,EAAE,MAAuC,CAAC;AAGtE,eAAO,MAAM,qBAAqB,EAAE,MACK,CAAC;AAG1C,eAAO,MAAM,yBAAyB,QAAwB,CAAC;AAG/D,eAAO,MAAM,wBAAwB,EAAE,MACH,CAAC;AAQrC,eAAO,MAAM,mBAAmB,EAAE,MAEjC,CAAC;AACF,eAAO,MAAM,gCAAgC,EAAE,MAE9C,CAAC;AACF,eAAO,MAAM,gCAAgC,EAAE,MAE9C,CAAC;AACF,eAAO,MAAM,+BAA+B,EAAE,MAE7C,CAAC;AACF,eAAO,MAAM,+BAA+B,EAAE,MAE7C,CAAC;AACF,eAAO,MAAM,2BAA2B,EAAE,MAEzC,CAAC;AAGF,eAAO,MAAM,oBAAoB,EAAE,MAElC,CAAC;AACF,eAAO,MAAM,iCAAiC,EAAE,MAE/C,CAAC;AACF,eAAO,MAAM,yBAAyB,EAAE,MAEvC,CAAC;AACF,eAAO,MAAM,6BAA6B,EAAE,MAE3C,CAAC;AACF,eAAO,MAAM,kCAAkC,EAAE,MAEhD,CAAC;AACF,eAAO,MAAM,gCAAgC,EAAE,MAE9C,CAAC;AACF,eAAO,MAAM,8BAA8B,EAAE,MAE5C,CAAC;AAGF,eAAO,MAAM,kBAAkB,EAAE,MAEhC,CAAC;AACF,eAAO,MAAM,oCAAoC,EAAE,MAElD,CAAC;AACF,eAAO,MAAM,mCAAmC,EAAE,MAEjD,CAAC;AACF,eAAO,MAAM,yCAAyC,EAAE,MACiB,CAAC;AAC1E,eAAO,MAAM,2BAA2B,EAAE,MAEzC,CAAC;AACF,eAAO,MAAM,2BAA2B,EAAE,MAEzC,CAAC;AACF,eAAO,MAAM,gCAAgC,EAAE,MAE9C,CAAC;AACF,eAAO,MAAM,gCAAgC,EAAE,MAE9C,CAAC;AACF,eAAO,MAAM,uCAAuC,EAAE,MACiB,CAAC;AAMxE,eAAO,MAAM,qBAAqB,EAAE,MAEnC,CAAC;AACF,eAAO,MAAM,mCAAmC,EAAE,MAEjD,CAAC;AACF,eAAO,MAAM,mCAAmC,EAAE,MAEjD,CAAC;AACF,eAAO,MAAM,iCAAiC,EAAE,MAE/C,CAAC;AACF,eAAO,MAAM,yCAAyC,EAAE,MACW,CAAC;AACpE,eAAO,MAAM,oCAAoC,EAAE,MAElD,CAAC;AACF,eAAO,MAAM,mCAAmC,EAAE,MAEjD,CAAC;AACF,eAAO,MAAM,qCAAqC,EAAE,MAEnD,CAAC;AACF,eAAO,MAAM,wCAAwC,EAAE,MACM,CAAC;AAC9D,eAAO,MAAM,sCAAsC,EAAE,MAEpD,CAAC;AACF,eAAO,MAAM,kCAAkC,EAAE,MAEhD,CAAC;AACF,eAAO,MAAM,uBAAuB,EAAE,MAErC,CAAC;AACF,eAAO,MAAM,+BAA+B,EAAE,MAE7C,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,aAAa,EAAE,SAAS;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB,EA4CA,CAAC"}

package/dist/templates/markdown/index.js

@@ -60,16 +60,12 @@ export const guidesCrossPlatformThinkingGuideContent = readLocalTemplate("spec/g
 // =============================================================================
 export const frameworkIndexContent = readLocalTemplate("framework/index.md.txt");
 export const frameworkRetrievalDailyGuideContent = readLocalTemplate("framework/retrieval-daily-guide.md.txt");
-export const frameworkCursorSemanticComplianceContent = readLocalTemplate("framework/cursor-semantic-compliance.md.txt");
-export const frameworkCursorSubagentPolicyContent = readLocalTemplate("framework/cursor-subagent-policy.md.txt");
+export const frameworkCodexWorkerDispatchContent = readLocalTemplate("framework/codex-worker-dispatch.md.txt");
 export const frameworkExecutionStrategyContent = readLocalTemplate("framework/execution-strategy.md.txt");
-export const frameworkCursorContextInjectionGuideContent = readLocalTemplate("framework/cursor-context-injection-guide.md.txt");
-export const frameworkCursorNativeModesGuideContent = readLocalTemplate("framework/cursor-native-modes-guide.md.txt");
 export const frameworkVerificationStrengthGuideContent = readLocalTemplate("framework/verification-strength-guide.md.txt");
 export const frameworkInjectionBudgetGuideContent = readLocalTemplate("framework/injection-budget-guide.md.txt");
 export const frameworkArtifactLocaleGuideContent = readLocalTemplate("framework/artifact-locale-guide.md.txt");
 export const frameworkPrdGrillFrontierGuideContent = readLocalTemplate("framework/prd-grill-frontier.md.txt");
-export const frameworkInternalSkillsReachabilityGuideContent = readLocalTemplate("framework/internal-skills-cursor-reachability.md.txt");
 export const frameworkDogfoodOnlySurfacesGuideContent = readLocalTemplate("framework/dogfood-only-surfaces.md.txt");
 export const frameworkParallelFirstExecutionContent = readLocalTemplate("framework/parallel-first-execution.md.txt");
 export const frameworkMiddlewareProtocolContent = readLocalTemplate("framework/middleware-protocol.md.txt");
@@ -87,22 +83,10 @@ export const frameworkDocs = [
         content: frameworkRetrievalDailyGuideContent,
     },
     {
-        name: "cursor-semantic-compliance.md",
-        content: frameworkCursorSemanticComplianceContent,
-    },
-    {
-        name: "cursor-subagent-policy.md",
-        content: frameworkCursorSubagentPolicyContent,
+        name: "codex-worker-dispatch.md",
+        content: frameworkCodexWorkerDispatchContent,
     },
     { name: "execution-strategy.md", content: frameworkExecutionStrategyContent },
-    {
-        name: "cursor-context-injection-guide.md",
-        content: frameworkCursorContextInjectionGuideContent,
-    },
-    {
-        name: "cursor-native-modes-guide.md",
-        content: frameworkCursorNativeModesGuideContent,
-    },
     {
         name: "verification-strength-guide.md",
         content: frameworkVerificationStrengthGuideContent,
@@ -119,10 +103,6 @@ export const frameworkDocs = [
         name: "prd-grill-frontier.md",
         content: frameworkPrdGrillFrontierGuideContent,
     },
-    {
-        name: "internal-skills-cursor-reachability.md",
-        content: frameworkInternalSkillsReachabilityGuideContent,
-    },
     {
         name: "dogfood-only-surfaces.md",
         content: frameworkDogfoodOnlySurfacesGuideContent,

package/dist/templates/markdown/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/templates/markdown/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/templates/markdown/index.ts"],"names":[],"mappings":"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"}

package/dist/templates/markdown/spec/backend/database-guidelines.md.txt

@@ -1,51 +1,51 @@
-# Database Guidelines
-
-> Database patterns and conventions for this project.
-
----
-
-## Overview
-
-<!--
-Document your project's database conventions here.
-
-Questions to answer:
-- What ORM/query library do you use?
-- How are migrations managed?
-- What are the naming conventions for tables/columns?
-- How do you handle transactions?
--->
-
-(To be filled by the team)
-
----
-
-## Query Patterns
-
-<!-- How should queries be written? Batch operations? -->
-
-(To be filled by the team)
-
----
-
-## Migrations
-
-<!-- How to create and run migrations -->
-
-(To be filled by the team)
-
----
-
-## Naming Conventions
-
-<!-- Table names, column names, index names -->
-
-(To be filled by the team)
-
----
-
-## Common Mistakes
-
-<!-- Database-related mistakes your team has made -->
-
-(To be filled by the team)
+# Database Guidelines
+
+> Database patterns and conventions for this project.
+
+---
+
+## Overview
+
+<!--
+Document your project's database conventions here.
+
+Questions to answer:
+- What ORM/query library do you use?
+- How are migrations managed?
+- What are the naming conventions for tables/columns?
+- How do you handle transactions?
+-->
+
+(To be filled by the team)
+
+---
+
+## Query Patterns
+
+<!-- How should queries be written? Batch operations? -->
+
+(To be filled by the team)
+
+---
+
+## Migrations
+
+<!-- How to create and run migrations -->
+
+(To be filled by the team)
+
+---
+
+## Naming Conventions
+
+<!-- Table names, column names, index names -->
+
+(To be filled by the team)
+
+---
+
+## Common Mistakes
+
+<!-- Database-related mistakes your team has made -->
+
+(To be filled by the team)