@captain_z/zsk 1.7.0 → 1.8.1

package/schemas/zsk-config.schema.json

@@ -2,7 +2,7 @@
   "$schema": "http://json-schema.org/draft-07/schema#",
   "$id": "https://unpkg.com/@captain_z/zsk/schemas/zsk-config.schema.json",
   "title": "ZSK Project Config",
-  "description": "Project-level configuration for ZSK resource origins, workspace paths, tools, and module index locations.",
+      "description": "Project-level configuration for ZSK raw source origins, workspace paths, tools, and module index locations.",
   "type": "object",
   "additionalProperties": false,
   "required": ["project", "paths", "sources", "tools", "modules"],
@@ -29,7 +29,7 @@
       }
     },
     "layoutVersion": {
-      "description": "Workspace layout version. Version 2 keeps all zsk-managed outputs under .zsk/ by default.",
+      "description": "Workspace layout version. Version 2 keeps all zsk-managed outputs under .zsk/ by default and prefers paths.raws for fact sources.",
       "type": "integer",
       "minimum": 2
     },
@@ -37,7 +37,15 @@
       "description": "Top-level project knowledge workspace paths.",
       "type": "object",
       "additionalProperties": false,
-      "required": ["docs", "modules", "resources", "issues", "evidence", "playwright"],
+      "required": ["docs", "modules", "issues", "evidence", "playwright"],
+      "anyOf": [
+        {
+          "required": ["raws"]
+        },
+        {
+          "required": ["resources"]
+        }
+      ],
       "properties": {
         "docs": {
           "$ref": "#/$defs/pathRef"
@@ -46,10 +54,11 @@
           "$ref": "#/$defs/pathRef"
         },
         "resources": {
+          "description": "Deprecated compatibility alias for paths.raws.",
           "$ref": "#/$defs/pathRef"
         },
         "raws": {
-          "description": "Legacy resource root accepted only for compatibility with older workspaces.",
+          "description": "Preferred immutable raw fact-source root.",
           "$ref": "#/$defs/pathRef"
         },
         "issues": {
@@ -61,16 +70,13 @@
         "playwright": {
           "$ref": "#/$defs/pathRef"
         },
-        "plans": {
-          "$ref": "#/$defs/pathRef"
-        },
         "metadata": {
           "$ref": "#/$defs/metadata"
         }
       }
     },
     "sources": {
-      "description": "Project-level resource origins. May be empty after init and filled by AI or zsk config setup.",
+      "description": "Project-level raw source origins. May be empty after init and filled by AI or zsk config setup.",
       "type": "object",
       "additionalProperties": {
         "$ref": "#/$defs/sourceRef"
@@ -96,7 +102,7 @@
           "uniqueItems": true
         },
         "design": {
-          "description": "Preferred tools for design and Figma resource capture.",
+          "description": "Preferred tools for design source and asset capture.",
           "type": "array",
           "items": {
             "$ref": "#/$defs/toolName"
@@ -225,7 +231,7 @@
       }
     },
     "sync": {
-      "description": "Optional deterministic or AI-assisted raw resource sync configuration.",
+      "description": "Optional deterministic or AI-assisted raw source sync configuration.",
       "type": "object",
       "additionalProperties": {
         "$ref": "#/$defs/syncRef"
@@ -268,12 +274,12 @@
       }
     },
     "sourceType": {
-      "description": "Resource role.",
+      "description": "Raw source role.",
       "type": "string",
       "enum": ["srs", "prd", "design", "api_contract", "backend_repo", "test_case", "design_asset", "vendor_doc", "manual"]
     },
     "sourceRef": {
-      "description": "Resource source reference.",
+      "description": "Raw source reference.",
       "type": "object",
       "additionalProperties": false,
       "required": ["type", "origin"],
@@ -310,9 +316,18 @@
         {
           "$ref": "#/$defs/modaoOrigin"
         },
+        {
+          "$ref": "#/$defs/designOrigin"
+        },
         {
           "$ref": "#/$defs/openapiOrigin"
         },
+        {
+          "$ref": "#/$defs/jiraOrigin"
+        },
+        {
+          "$ref": "#/$defs/srsOrigin"
+        },
         {
           "$ref": "#/$defs/manualOrigin"
         }
@@ -360,7 +375,7 @@
       "properties": {
         "kind": {
           "type": "string",
-          "const": "git"
+          "enum": ["git", "git-submodule"]
         },
         "repository": {
           "type": "string",
@@ -422,6 +437,35 @@
         }
       }
     },
+    "designOrigin": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["kind", "provider"],
+      "properties": {
+        "kind": {
+          "type": "string",
+          "const": "design"
+        },
+        "provider": {
+          "type": "string",
+          "minLength": 1
+        },
+        "url": {
+          "type": "string",
+          "minLength": 1
+        },
+        "path": {
+          "$ref": "#/$defs/pathRef"
+        },
+        "id": {
+          "type": "string",
+          "minLength": 1
+        },
+        "metadata": {
+          "$ref": "#/$defs/metadata"
+        }
+      }
+    },
     "openapiOrigin": {
       "type": "object",
       "additionalProperties": false,
@@ -451,6 +495,71 @@
         }
       ]
     },
+    "jiraOrigin": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["kind"],
+      "properties": {
+        "kind": {
+          "type": "string",
+          "const": "jira"
+        },
+        "url": {
+          "type": "string",
+          "minLength": 1
+        },
+        "path": {
+          "$ref": "#/$defs/pathRef"
+        },
+        "jql": {
+          "type": "string",
+          "minLength": 1
+        },
+        "metadata": {
+          "$ref": "#/$defs/metadata"
+        }
+      },
+      "anyOf": [
+        {
+          "required": ["url"]
+        },
+        {
+          "required": ["path"]
+        },
+        {
+          "required": ["jql"]
+        }
+      ]
+    },
+    "srsOrigin": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["kind"],
+      "properties": {
+        "kind": {
+          "type": "string",
+          "const": "srs"
+        },
+        "url": {
+          "type": "string",
+          "minLength": 1
+        },
+        "path": {
+          "$ref": "#/$defs/pathRef"
+        },
+        "metadata": {
+          "$ref": "#/$defs/metadata"
+        }
+      },
+      "anyOf": [
+        {
+          "required": ["url"]
+        },
+        {
+          "required": ["path"]
+        }
+      ]
+    },
     "manualOrigin": {
       "type": "object",
       "additionalProperties": false,

package/templates/issue/default/issue.md

@@ -4,6 +4,10 @@
 
 __ISSUE_TYPE__
 
+## 作用域
+
+__ISSUE_SCOPE__
+
 ## 问题级别
 
 __SEVERITY__
@@ -66,7 +70,7 @@ __SEVERITY__
   - [ ] `.zsk/modules/{module}/design.md`
   - [ ] `.zsk/modules/{module}/tasks.md`
   - [ ] `.zsk/docs/SYSTEM-SPEC.md`
-  - [ ] `.zsk/resources`
+  - [ ] `.zsk/raws`
 - 更新内容或 no-update rationale：
 - 反哺时机：修复通过 verify 且经用户/产品确认后执行
 

package/templates/module/frontend-module/design.md

@@ -1,5 +1,26 @@
 # __MODULE_NAME__ Design
 
+## Implementation Map
+
+| Requirement / AC | Surface | Files / Modules | Interface / State / Data Flow | Risk |
+| --- | --- | --- | --- | --- |
+| FR-001 / AC-001 |  |  |  |  |
+
+## Decisions
+
+| Decision | Alternatives Rejected | Rationale / Evidence | Rollback / Migration Note |
+| --- | --- | --- | --- |
+|  |  |  |  |
+
+## States And Failure Modes
+
+| State | User/System Observable Behavior | Test / Demo Evidence |
+| --- | --- | --- |
+| loading |  |  |
+| empty |  |  |
+| error |  |  |
+| permission |  |  |
+
 ## Playwright Locator And State Strategy
 
 | Scenario | Page / Route | Preferred Locator Strategy | State Coverage | API / Mock | Auth / Storage | Evidence |
@@ -11,6 +32,7 @@ Guidelines:
 - Prefer user-facing locators: `getByRole`, `getByLabel`, `getByPlaceholder`, `getByTestId`.
 - Add implementation tasks for missing accessible names, labels, or stable test ids.
 - Define auth/storage reuse before demo so Playwright can run repeatably.
+- Route unclear behavior back to spec instead of redesigning requirements here.
 
 ## Documentation Feedback
 

package/templates/module/frontend-module/proposal.md

@@ -1,7 +1,32 @@
 # __MODULE_NAME__ Proposal
 
+## Problem
+
+- Target user / stakeholder:
+- Problem:
+- Why now:
+- Source evidence:
+
+## Scope
+
+- In scope:
+- Out of scope:
+- Assumptions:
+- Open questions / blockers:
+
+## Success Criteria
+
+| Criterion | Evidence Source | Owner / Next Stage |
+| --- | --- | --- |
+|  |  |  |
+
+## Risks And Rejected Alternatives
+
+| Item | Decision | Rationale / Evidence |
+| --- | --- | --- |
+|  |  |  |
+
 ## Documentation Feedback
 
 - No-update rationale:
   - Created from the ZSK module template; no proposal has been drafted yet.
-

package/templates/module/frontend-module/spec.md

@@ -1,5 +1,17 @@
 # __MODULE_NAME__ Spec
 
+## Behavior Contract
+
+| ID | Requirement | Type | Source / Decision | Priority | Observable Outcome |
+| --- | --- | --- | --- | --- | --- |
+| FR-001 |  | FR |  | P0 |  |
+
+## Acceptance Criteria
+
+| AC | Linked Requirement | Given / When / Then | Evidence Route |
+| --- | --- | --- | --- |
+| AC-001 | FR-001 | Given  / When  / Then  |  |
+
 ## Scenario Contracts
 
 | Scenario | User Goal | Entry | Preconditions | Observable Result | PRD/SRS / FR/AC | Automate |
@@ -13,6 +25,7 @@ Rules:
 - Mark unclear or conflicting facts as blockers instead of choosing behavior silently.
 - Do not write brittle selectors in spec.
 - Mark which P0/P1 scenarios must become Playwright cases.
+- Keep implementation choices out unless they are part of the product contract.
 
 ## Documentation Feedback
 

package/templates/module/frontend-module/tasks.md

@@ -1,5 +1,17 @@
 # __MODULE_NAME__ Tasks
 
+## Execution Plan
+
+| ID | Task | Depends On | Scope / Files | Linked FR/AC | Evidence Hook | Status |
+| --- | --- | --- | --- | --- | --- | --- |
+| T-001 |  |  |  | FR-001 / AC-001 |  | TODO |
+
+## Coverage Matrix
+
+| FR/AC | Implementation Task | Test / Scenario Task | Docs / Issue / Evidence Task |
+| --- | --- | --- | --- |
+| FR-001 / AC-001 | T-001 |  |  |
+
 ## Playwright Case Tasks
 
 | Task | Scenario Contract | Case File | Fixture/Auth | Reuse Target | Status |
@@ -12,6 +24,7 @@ Rules:
 - Create or update source-aligned tests/scenarios before implementation for testable behavior changes.
 - Tag cases as smoke/demo/verify/regression.
 - Include tasks for labels/test ids required by stable locators.
+- Do not create vague tasks such as "implement feature"; each task needs scope, dependency, and evidence.
 
 ## Documentation Feedback
 

package/templates/project-init/.zsk/config.yaml

@@ -8,15 +8,15 @@ project:
 paths:
   docs: .zsk/docs
   modules: .zsk/modules
-  resources: .zsk/resources
+  raws: .zsk/raws
   issues: .zsk/issues
   evidence: .zsk/evidence
   playwright: .zsk/playwright
-  plans: .zsk/plans
 
-# Resource origins. AI or zsk config setup should fill these with online URLs,
-# git repositories, Figma/Modao links, OpenAPI locations, or local files.
-# Optional snapshots should land under paths.resources, for example:
+# Raw source origins. AI or zsk config setup should fill these with online URLs,
+# git repositories, design-platform links/assets, OpenAPI locations, or local files.
+# Optional snapshots should land under paths.raws with stable role/provider paths.
+# Dates belong in manifest metadata such as syncedAt, not in path authority.
 #
 # sources:
 #   srs:
@@ -24,26 +24,27 @@ paths:
 #     origin:
 #       kind: url
 #       url: https://example.com/srs
-#     snapshot: .zsk/resources/requirements/srs.md
-#   figma_main:
+#     snapshot: .zsk/raws/product/srs.md
+#   design_main:
 #     type: design
 #     origin:
-#       kind: figma
+#       kind: design
+#       provider: figma
 #       url: https://www.figma.com/file/...
-#     snapshot: .zsk/resources/design-sources/figma-main.json
+#     snapshot: .zsk/raws/ue/design-main.json
 #   backend_api:
-#     type: backend_repo
+#     type: api_contract
 #     origin:
 #       kind: git
 #       repository: https://github.com/example/backend-api.git
 #       path: openapi.yaml
-#     snapshot: .zsk/resources/backend-repositories/backend-openapi.yaml
+#     snapshot: .zsk/raws/backend/api-contract.yaml
 #   acceptance_cases:
 #     type: test_case
 #     origin:
 #       kind: url
 #       url: https://example.com/qa-cases
-#     snapshot: .zsk/resources/testing/acceptance-cases.md
+#     snapshot: .zsk/raws/qa/testing/acceptance-cases.md
 sources: {}
 
 tools:
@@ -54,10 +55,11 @@ tools:
     - computer_use
     - browser_use
   design:
+    - manual
     - figma_mcp
 
 modules:
-  index: .zsk/modules/_module-index.md
+  index: .zsk/modules/index.md
   root: .zsk/modules
 
 automation:
@@ -70,7 +72,7 @@ automation:
     command: pnpm deploy:staging
   demo:
     # Default optimized lane:
-    # - Formal test cases come from module tests.raw_cases or sources.testing, normally snapshots under .zsk/resources/testing.
+    # - Formal test cases come from module tests.raw_cases or sources.testing, normally snapshots under .zsk/raws/qa/testing.
     # - Playwright storageState is the preferred way to reuse login/session state without stopping on login pages.
     # - Computer Use is the preferred visual/current-page observation lane when it is available and authorized.
     # - Browser Use is optional and runtime-specific; use it only where the agent platform supports it and permissions are available.
@@ -81,8 +83,8 @@ automation:
     defaultMode: optimized
     baseUrl: http://localhost:3000
     command: pnpm dev
-    evidenceDir: .zsk/evidence/{module}/demo
-    scenarioDir: .zsk/playwright/{module}/specs
+    evidenceDir: .zsk/modules/{module}/_evidence/demo
+    scenarioDir: .zsk/modules/{module}/_playwright/specs
     playwright:
       config: playwright.config.ts
       project: chromium
@@ -97,8 +99,8 @@ automation:
       # Fall back to playwright_mcp for structured accessibility snapshots, or browser_use only on runtimes that support it.
       decisionTool: playwright_mcp
       executionTool: playwright
-      planFile: .zsk/playwright/{module}/execution/operation-plan.json
-      executionFile: .zsk/playwright/{module}/execution/playwright-execution.json
+      planFile: .zsk/modules/{module}/_playwright/execution/operation-plan.json
+      executionFile: .zsk/modules/{module}/_playwright/execution/playwright-execution.json
   verify:
     commands:
       - pnpm test:e2e

package/templates/project-init/.zsk/docs/PROJECT-CONFIG.md

@@ -2,6 +2,16 @@
 
 This file is the human-readable companion to `.zsk/config.yaml`.
 
+## Halcyon Layer
+
+This `.zsk/` workspace is project-specific. It is the Halcyon operating layer for this project: the place where AI agents read raw facts, produce stage documents, route issues/evidence, and prove stage completion. It is not a generic docs folder and it is not a replacement for the application's source tree.
+
+Use this layer to answer three questions before execution:
+
+- What facts and decisions are authoritative for this project?
+- Which module/stage owns the next artifact?
+- What evidence or issue update proves the stage is complete?
+
 ## Workspace Layout
 
 `zsk init` owns only the `.zsk/` workspace by default:
@@ -11,10 +21,11 @@ This file is the human-readable companion to `.zsk/config.yaml`.
 | `.zsk/config.yaml` | Machine-readable project config and path authority |
 | `.zsk/docs/` | Project-level docs such as this file and `SYSTEM-SPEC.md` |
 | `.zsk/modules/{module}/` | Module `module.yaml`, `proposal.md`, `spec.md`, `design.md`, `tasks.md` |
-| `.zsk/resources/` | Shared source snapshots and manually provided resources |
-| `.zsk/issues/` | Issues and issue indexes created on demand |
-| `.zsk/evidence/` | Runtime evidence, screenshots, traces, logs, and verification artifacts |
-| `.zsk/playwright/{module}/` | Playwright specs, plans, auth state, results, reports, and execution records |
+| `.zsk/raws/` | Immutable raw fact sources and manifest/index files |
+| `.zsk/modules/{module}/_issues/` | Module-private issue records, created on demand |
+| `.zsk/modules/{module}/_evidence/` | Module-private evidence, screenshots, traces, logs, and verification artifacts, created on demand |
+| `.zsk/modules/{module}/_playwright/` | Module-specific Playwright specs, plans, auth state, results, reports, and execution records, created on demand |
+| `.zsk/playwright/` | Shared Playwright config/auth/helpers only, created on demand |
 
 Root `docs/`, `.raws/`, `.issues/`, and `.playwright/` are not default write targets. Use explicit export or migration tooling when you need project-root copies.
 
@@ -23,17 +34,29 @@ Root `docs/`, `.raws/`, `.issues/`, and `.playwright/` are not default write tar
 1. `.zsk/config.yaml`
 2. `.zsk/docs/SYSTEM-SPEC.md`
 3. Project resource origins listed under `.zsk/config.yaml#sources`
-4. `.zsk/modules/{module}/module.yaml`
-5. `.zsk/modules/{module}/spec.md`
-6. `.zsk/modules/{module}/design.md`
-7. Runtime evidence under `.zsk/evidence/` and `.zsk/playwright/`
+4. `.zsk/raws/manifest.json` and `.zsk/raws/index.md`
+5. `.zsk/modules/{module}/module.yaml`
+6. `.zsk/modules/{module}/spec.md`
+7. `.zsk/modules/{module}/design.md`
+8. Runtime evidence under module `_evidence` / `_playwright` or shared `.zsk/evidence` / `.zsk/playwright`
+
+When sources conflict, record the conflict under the module `_issues` directory, or shared `.zsk/issues` only for cross-module/global issues, and update the affected module docs with a Documentation Feedback note or an explicit no-update rationale.
+
+## Authoring Rule
+
+Every module stage document is a handoff contract:
+
+- `proposal.md` explains why the work exists, who it serves, what is in scope, what is out of scope, and how success will be recognized.
+- `spec.md` defines observable behavior, scenarios, acceptance criteria, edge cases, and source-linked assumptions.
+- `design.md` maps approved behavior to implementation surfaces, interfaces, state, data flow, risks, and verification strategy.
+- `tasks.md` breaks the design into ordered work with owners/scope, dependencies, FR/AC coverage, and evidence hooks.
 
-When sources conflict, record the conflict under `.zsk/issues/{module}/` and update the affected module docs with a Documentation Feedback note or an explicit no-update rationale.
+If a document cannot answer its stage questions, stop and record the missing source, decision, blocker, or issue instead of filling the template.
 
 ## Maintenance Checklist
 
 - Update `.zsk/config.yaml` when paths, tools, or source origins change.
 - Keep project-wide reusable rules in `.zsk/docs/SYSTEM-SPEC.md`.
 - Keep module-specific decisions in `.zsk/modules/{module}/`.
-- Keep shared raw resources under `.zsk/resources/`.
-- Keep runtime outputs out of docs and under `.zsk/evidence/` or `.zsk/playwright/`.
+- Keep shared raw source facts under `.zsk/raws/`.
+- Keep runtime outputs out of docs and under module-private `_evidence` / `_playwright` unless they are deliberately shared under `.zsk/evidence` / `.zsk/playwright`.

package/templates/project-init/.zsk/docs/SYSTEM-SPEC.md

@@ -2,20 +2,33 @@
 
 This document captures project-wide rules that should guide module work.
 
+## Operating Model
+
+The `.zsk/` workspace is this project's Halcyon layer. It keeps AI execution grounded by separating:
+
+- raw facts under `paths.raws`;
+- project-wide rules under `paths.docs`;
+- module-owned stage contracts under `paths.modules`;
+- runtime evidence under module `_evidence` or shared `paths.evidence`;
+- issue records under module `_issues` or shared/global `paths.issues`;
+- Playwright plans/specs/results under module `_playwright` or shared `paths.playwright`.
+
+Agents must use the smallest sufficient lane: read local sources first, run deterministic CLI checks when possible, delegate only when the work has independent expert lanes, and record blockers instead of filling missing facts from chat memory.
+
 ## Path Boundaries
 
 - `paths.docs` stores project-level docs only.
 - `paths.modules` stores module source-of-truth docs.
-- `paths.resources` stores shared source snapshots and manually provided resources.
-- `paths.issues` stores actionable issue records and indexes created on demand.
-- `paths.evidence` stores runtime evidence and verification artifacts.
-- `paths.playwright` stores Playwright specs, plans, auth state, results, reports, and execution records.
+- `paths.raws` stores immutable shared source snapshots and manually provided fact sources.
+- Module `_issues` stores module-specific actionable issue records; `paths.issues` is created on demand only for shared/global indexes or cross-module issues.
+- Module `_evidence` stores module-specific runtime evidence and verification artifacts; `paths.evidence` is created on demand only for shared/global evidence.
+- Module `_playwright` stores module-specific Playwright specs, plans, auth state, results, reports, and execution records; `paths.playwright` is created on demand only for shared Playwright assets.
 
 Root `docs/`, `.raws/`, `.issues/`, and `.playwright/` are legacy or export surfaces, not default zsk write targets.
 
 ## Testing Assets
 
-Original QA, acceptance, release, and manually supplied test cases belong in configured project sources and may be snapshotted under `paths.resources`. Module-derived test plans and Playwright specs belong under `paths.playwright/{module}`.
+Original QA, acceptance, release, and manually supplied test cases belong in configured project sources and may be snapshotted under `paths.raws`, normally `.zsk/raws/qa/testing`. Module-derived test plans and Playwright specs belong under module `_playwright` unless they are intentionally shared under `paths.playwright`.
 
 ## Completion Feedback
 
@@ -25,3 +38,22 @@ Every stage document that changes durable behavior should include Documentation
 - an explicit no-update rationale.
 
 Runtime evidence should be linked from docs, not embedded in docs.
+
+## Stage Document Standards
+
+ZSK stage documents are decision artifacts. They are complete only when the next stage can act without hidden chat context.
+
+| Stage | Document Mode | Must Prove |
+| --- | --- | --- |
+| `prepare` | Evidence report | Source origins, freshness, conflicts, and raw snapshot paths are known before planning. |
+| `proposal` | Decision brief | Problem, user/business outcome, scope, non-goals, risks, and success criteria are explicit. |
+| `spec` | Behavior contract | FR/NFR, scenarios, edge cases, and acceptance criteria are observable and source-linked. |
+| `design` | Implementation contract | Behavior maps to files/modules/interfaces/state/data flow, with risks and verification strategy. |
+| `task` | Execution plan | Work is ordered, owned, independently reviewable, and tied to FR/AC plus evidence hooks. |
+| `coding` | Implementation evidence | Changed files, behavior, tests, and residual risks are tied back to tasks. |
+| `smoke` | Evidence report | Local proof names the claim, command/scenario, result, artifacts, and failures. |
+| `review` | Evidence report | Findings are severity-ranked, traceable, and cover scope, correctness, tests, risk, and harness compliance. |
+| `ready` | Verification handoff | Fixed issues, AC, evidence, replay steps, version, and residual risks are mapped. |
+| `verify` | Independent evidence | The ready claim is replayed with fresh evidence and pass/fail issue status updates. |
+
+Each stage document must separate facts, decisions, assumptions, open questions, evidence, and next action. Do not leave template filler, untraceable "best practice" claims, vague tasks, or unresolved contradictions in a stage artifact.

package/templates/project-init/.zsk/modules/index.md

@@ -0,0 +1,7 @@
+# Module Index
+
+Generated and refreshed as modules are added.
+
+| Module | Status | Notes |
+| --- | --- | --- |
+|  |  |  |

package/templates/project-init/.zsk/raws/backend/index.md

@@ -0,0 +1,3 @@
+# Backend Sources
+
+Backend repositories, API contracts, OpenAPI files, and integration notes.

package/templates/project-init/.zsk/raws/index.md

@@ -0,0 +1,7 @@
+# Raw Source Index
+
+Immutable fact sources for this project. Generated and refreshed by `zsk prep`.
+
+| Provider | Type | Status | Snapshot / Origin |
+| --- | --- | --- | --- |
+|  |  |  |  |

package/templates/project-init/.zsk/raws/jira/index.md

@@ -0,0 +1,3 @@
+# Jira Sources
+
+Jira exports, linked issue references, and ticket snapshots.

package/templates/project-init/.zsk/raws/manifest.json

@@ -0,0 +1,4 @@
+{
+  "version": 1,
+  "resources": []
+}

package/templates/project-init/.zsk/raws/manual/index.md

@@ -0,0 +1,3 @@
+# Manual Sources
+
+Manually supplied notes, local files, and ad hoc source material.

package/templates/project-init/.zsk/raws/product/index.md

@@ -0,0 +1,3 @@
+# Product Sources
+
+SRS, PRD, requirements, release notes, and customer/product feedback.

package/templates/project-init/.zsk/raws/qa/index.md

@@ -0,0 +1,3 @@
+# QA Sources
+
+QA cases, acceptance cases, test data, and verification source material.

package/templates/project-init/.zsk/raws/ue/index.md

@@ -0,0 +1,3 @@
+# UE Sources
+
+Design handoff, Figma/Modao references, UX notes, and interaction assets.

package/templates/project-init/.zsk/evidence/.gitkeep

@@ -1 +0,0 @@
-