@jahanxu/trellis 0.4.1 → 0.5.0

package/dist/templates/iflow/commands/trellis/pick-task.md

@@ -0,0 +1,145 @@
+# Pick Task - Select Upstream Deliverable and Start Working
+
+Pick a deliverable from an upstream pool, create a task directory, and inject upstream context.
+
+---
+
+## Usage
+
+```
+/trellis:pick-task <pool> <id>
+```
+
+- `<pool>`: `requirements` (for Designers) or `prototypes` (for Frontend)
+- `<id>`: deliverable ID to pick (e.g., `user-login`)
+
+---
+
+## Process `[AI]`
+
+### Step 1: Validate Role
+
+```bash
+python3 ./.trellis/scripts/get_context.py
+```
+
+Read the developer name from `.developer` file. Parse role from `{role}-{name}` convention.
+
+Validate role-pool match:
+- `designer` can pick from `requirements`
+- `frontend` / `frontend-impl` can pick from `prototypes`
+- `pm` should NOT pick from pools (PMs create tasks directly)
+
+If role cannot be parsed, warn but continue (soft detection).
+
+### Step 2: Check Pool Availability
+
+```bash
+python3 ./.trellis/scripts/pool.py status <pool> <id>
+```
+
+Verify the item:
+- Exists in the pool
+- Status is `available` (not `consumed`)
+
+If not available, list what IS available:
+```bash
+python3 ./.trellis/scripts/pool.py list <pool>
+```
+
+### Step 3: Check Current Task
+
+If there is already a current task set, ask:
+> "You have an active task: `<current-task>`. Would you like to finish it first, or switch to the new task?"
+
+If user wants to continue, proceed.
+
+### Step 4: Create Task Directory
+
+Determine task suffix based on pool:
+- `requirements` pool -> `{id}-prototype`
+- `prototypes` pool -> `{id}-impl`
+
+```bash
+TASK_DIR=$(python3 ./.trellis/scripts/task.py create "<title>" --slug <id>-<suffix>)
+```
+
+### Step 5: Write source.json
+
+Create `source.json` in the task directory to reference upstream:
+
+```json
+{
+  "based_on": {
+    "type": "<requirement|prototype>",
+    "id": "<id>",
+    "path": "<deliverable path>",
+    "handoff_doc": "<path>/HANDOFF.md"
+  }
+}
+```
+
+Write this file:
+```bash
+cat > "$TASK_DIR/source.json" << 'EOF'
+{content}
+EOF
+```
+
+### Step 6: Configure Context (JSONL)
+
+Initialize context files for the task:
+
+```bash
+python3 ./.trellis/scripts/task.py init-context "$TASK_DIR" frontend
+```
+
+Add upstream deliverable files and role specs to context:
+
+```bash
+# Add role spec
+python3 ./.trellis/scripts/task.py add-context "$TASK_DIR" implement ".trellis/spec/roles/<role>/index.md" "Role guidelines"
+
+# Add upstream HANDOFF doc
+python3 ./.trellis/scripts/task.py add-context "$TASK_DIR" implement "<handoff_doc>" "Upstream handoff document"
+
+# Add upstream deliverable directory files
+# (add each significant file from the upstream output)
+python3 ./.trellis/scripts/task.py add-context "$TASK_DIR" implement "<upstream_file>" "Upstream deliverable"
+```
+
+### Step 7: Consume from Pool
+
+```bash
+python3 ./.trellis/scripts/pool.py consume <pool> <id> <developer>
+```
+
+### Step 8: Activate Task
+
+```bash
+python3 ./.trellis/scripts/task.py start "$TASK_DIR"
+```
+
+### Step 9: Read Upstream Context
+
+Read and summarize the upstream deliverables for the user:
+
+1. Read the HANDOFF.md document
+2. List all upstream files
+3. Summarize key points the user should know
+
+### Step 10: Report
+
+```
+Task picked and ready!
+- Task: <task-dir>
+- Based on: <pool>/<id>
+- Upstream: <deliverable-path>
+- Role specs loaded: .trellis/spec/roles/<role>/
+
+Key points from upstream HANDOFF:
+- (summary point 1)
+- (summary point 2)
+
+What would you like to work on first?
+```

package/dist/templates/iflow/hooks/inject-subagent-context.py

@@ -21,6 +21,7 @@ Context Source: .trellis/.current-task points to task directory
 - info.md         - Technical design
 - codex-review-output.txt - Code Review results
 """
+from __future__ import annotations
 
 # IMPORTANT: Suppress all warnings FIRST
 import warnings

package/dist/templates/iflow/hooks/ralph-loop.py

@@ -17,6 +17,7 @@ State file: .trellis/.ralph-state.json
 - Tracks current iteration count per session
 - Resets when task changes
 """
+from __future__ import annotations
 
 # IMPORTANT: Suppress all warnings FIRST
 import warnings

package/dist/templates/iflow/hooks/session-start.py

@@ -3,6 +3,7 @@
 """
 Session Start Hook - Inject structured context
 """
+from __future__ import annotations
 
 # IMPORTANT: Suppress all warnings FIRST
 import warnings
@@ -65,6 +66,166 @@ def run_script(script_path: Path) -> str:
         return "No context available"
 
 
+def detect_role(trellis_dir: Path) -> str | None:
+    """Detect role from developer name ({role}-{name} convention)."""
+    dev_file = trellis_dir / ".developer"
+    if not dev_file.is_file():
+        return None
+    try:
+        content = dev_file.read_text(encoding="utf-8")
+        for line in content.splitlines():
+            if line.startswith("name="):
+                name = line.split("=", 1)[1].strip()
+                if "-" in name:
+                    role = name.split("-", 1)[0]
+                    if role in ("pm", "designer", "frontend", "frontend-impl"):
+                        return role
+    except (OSError, IOError):
+        pass
+    return None
+
+
+def inject_upstream_context(trellis_dir: Path, project_dir: Path, output: StringIO) -> None:
+    """Inject upstream context when source.json exists in current task."""
+    current_task_file = trellis_dir / ".current-task"
+    if not current_task_file.is_file():
+        return
+
+    try:
+        task_rel = current_task_file.read_text(encoding="utf-8").strip()
+    except (OSError, IOError):
+        return
+
+    if not task_rel:
+        return
+
+    task_dir = project_dir / task_rel
+    source_file = task_dir / "source.json"
+    if not source_file.is_file():
+        return
+
+    try:
+        source = json.loads(source_file.read_text(encoding="utf-8"))
+    except (json.JSONDecodeError, OSError):
+        return
+
+    based_on = source.get("based_on")
+    if not based_on:
+        return
+
+    output.write("<upstream-context>\n")
+    output.write("## Based on Upstream Deliverable\n")
+    output.write(f"- Type: {based_on.get('type', '?')}\n")
+    output.write(f"- ID: {based_on.get('id', '?')}\n")
+    output.write(f"- Path: {based_on.get('path', '?')}\n\n")
+
+    handoff_path = project_dir / based_on.get("handoff_doc", "")
+    if handoff_path.is_file():
+        output.write("### Handoff Document\n")
+        handoff_content = read_file(handoff_path)
+        if len(handoff_content) > 3000:
+            handoff_content = handoff_content[:3000] + "\n... (truncated)"
+        output.write(handoff_content)
+        output.write("\n\n")
+
+    source_path = project_dir / based_on.get("path", "")
+    if source_path.is_dir():
+        output.write("### Upstream Deliverable Files\n")
+        total_size = 0
+        text_exts = {".md", ".txt", ".tsx", ".ts", ".jsx", ".js", ".vue", ".css", ".json", ".yaml", ".yml", ".html"}
+        for fpath in sorted(source_path.rglob("*")):
+            if not fpath.is_file():
+                continue
+            if fpath.name == "HANDOFF.md":
+                continue
+            if fpath.suffix not in text_exts:
+                continue
+            if total_size >= 50000:
+                output.write("\n(total size cap reached, remaining files omitted)\n")
+                break
+            try:
+                content = fpath.read_text(encoding="utf-8")
+            except (OSError, UnicodeDecodeError):
+                continue
+            rel = fpath.relative_to(source_path)
+            output.write(f"\n#### {rel}\n")
+            ext = fpath.suffix[1:] if fpath.suffix else ""
+            if len(content) > 3000:
+                content = content[:3000] + "\n... (truncated)"
+            output.write(f"```{ext}\n{content}\n```\n")
+            total_size += len(content)
+
+    output.write("</upstream-context>\n\n")
+
+
+def inject_pool_summary(trellis_dir: Path, output: StringIO) -> None:
+    """Inject available tasks summary from pool files."""
+    pool_dir = trellis_dir / "pool"
+    if not pool_dir.is_dir():
+        return
+
+    pool_files = sorted(pool_dir.glob("*.json"))
+    if not pool_files:
+        return
+
+    has_available = False
+    pool_output = StringIO()
+
+    for pool_file in pool_files:
+        try:
+            data = json.loads(pool_file.read_text(encoding="utf-8"))
+        except (json.JSONDecodeError, OSError):
+            continue
+
+        available = [
+            i for i in data.get("available", [])
+            if i.get("status") == "available"
+        ]
+        if not available:
+            continue
+
+        has_available = True
+        pool_name = pool_file.stem
+        pool_output.write(f"## Available in {pool_name} ({len(available)})\n")
+        for item in available:
+            completed_by = item.get("completed_by", "?")
+            completed_at = item.get("completed_at", "?")
+            pool_output.write(
+                f"- {item.get('id', '?')}: {item.get('title', '?')} "
+                f"(by {completed_by}, {completed_at})\n"
+            )
+        pool_output.write("\n")
+
+    if has_available:
+        output.write("<available-tasks>\n")
+        output.write(pool_output.getvalue())
+        output.write("Use `/trellis:pick-task <pool> <id>` to start working on an available item.\n")
+        output.write("</available-tasks>\n\n")
+
+
+def inject_role_guidelines(trellis_dir: Path, role: str | None, output: StringIO) -> None:
+    """Inject role-specific guidelines if role is detected."""
+    if not role:
+        return
+
+    role_dir_map = {
+        "pm": "pm",
+        "designer": "designer",
+        "frontend": "frontend-impl",
+        "frontend-impl": "frontend-impl",
+    }
+
+    role_dir = role_dir_map.get(role)
+    if not role_dir:
+        return
+
+    role_index = trellis_dir / "spec" / "roles" / role_dir / "index.md"
+    if role_index.is_file():
+        output.write(f"## Role: {role}\n")
+        output.write(read_file(role_index))
+        output.write("\n\n")
+
+
 def main():
     if should_skip_injection():
         sys.exit(0)
@@ -95,6 +256,10 @@ Read and follow all instructions below carefully.
 
     output.write("<guidelines>\n")
 
+    # Detect role and inject role-specific guidelines
+    role = detect_role(trellis_dir)
+    inject_role_guidelines(trellis_dir, role, output)
+
     output.write("## Frontend\n")
     frontend_index = read_file(
         trellis_dir / "spec" / "frontend" / "index.md", "Not configured"
@@ -117,6 +282,12 @@ Read and follow all instructions below carefully.
 
     output.write("\n</guidelines>\n\n")
 
+    # Inject upstream context (from source.json in current task)
+    inject_upstream_context(trellis_dir, project_dir, output)
+
+    # Inject pool summary (available tasks)
+    inject_pool_summary(trellis_dir, output)
+
     output.write("<instructions>\n")
     start_md = read_file(
         iflow_dir / "commands" / "trellis" / "start.md", "No start.md found"

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

@@ -24,4 +24,13 @@ export declare const frontendStateManagementContent: string;
 export declare const guidesIndexContent: string;
 export declare const guidesCrossLayerThinkingGuideContent: string;
 export declare const guidesCodeReuseThinkingGuideContent: string;
+export declare const rolePmIndexContent: string;
+export declare const rolePmPrdTemplateContent: string;
+export declare const rolePmRequirementChecklistContent: string;
+export declare const roleDesignerIndexContent: string;
+export declare const roleDesignerPrototypeGuidelinesContent: string;
+export declare const roleDesignerMockDataStandardsContent: string;
+export declare const roleFrontendImplIndexContent: string;
+export declare const roleFrontendImplApiIntegrationContent: string;
+export declare const roleFrontendImplPrototypeToProductionContent: string;
 //# sourceMappingURL=index.d.ts.map

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"}
+{"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;AAGF,eAAO,MAAM,kBAAkB,EAAE,MAEhC,CAAC;AACF,eAAO,MAAM,wBAAwB,EAAE,MAEtC,CAAC;AACF,eAAO,MAAM,iCAAiC,EAAE,MAE/C,CAAC;AACF,eAAO,MAAM,wBAAwB,EAAE,MAEtC,CAAC;AACF,eAAO,MAAM,sCAAsC,EAAE,MAEpD,CAAC;AACF,eAAO,MAAM,oCAAoC,EAAE,MAElD,CAAC;AACF,eAAO,MAAM,4BAA4B,EAAE,MAE1C,CAAC;AACF,eAAO,MAAM,qCAAqC,EAAE,MAEnD,CAAC;AACF,eAAO,MAAM,4CAA4C,EAAE,MACmB,CAAC"}

package/dist/templates/markdown/index.js

@@ -49,4 +49,14 @@ export const frontendStateManagementContent = readLocalTemplate("spec/frontend/s
 export const guidesIndexContent = readLocalTemplate("spec/guides/index.md.txt");
 export const guidesCrossLayerThinkingGuideContent = readLocalTemplate("spec/guides/cross-layer-thinking-guide.md.txt");
 export const guidesCodeReuseThinkingGuideContent = readLocalTemplate("spec/guides/code-reuse-thinking-guide.md.txt");
+// Role spec templates (three-role collaboration pipeline)
+export const rolePmIndexContent = readLocalTemplate("spec/roles/pm/index.md.txt");
+export const rolePmPrdTemplateContent = readLocalTemplate("spec/roles/pm/prd-template.md.txt");
+export const rolePmRequirementChecklistContent = readLocalTemplate("spec/roles/pm/requirement-checklist.md.txt");
+export const roleDesignerIndexContent = readLocalTemplate("spec/roles/designer/index.md.txt");
+export const roleDesignerPrototypeGuidelinesContent = readLocalTemplate("spec/roles/designer/prototype-guidelines.md.txt");
+export const roleDesignerMockDataStandardsContent = readLocalTemplate("spec/roles/designer/mock-data-standards.md.txt");
+export const roleFrontendImplIndexContent = readLocalTemplate("spec/roles/frontend-impl/index.md.txt");
+export const roleFrontendImplApiIntegrationContent = readLocalTemplate("spec/roles/frontend-impl/api-integration.md.txt");
+export const roleFrontendImplPrototypeToProductionContent = readLocalTemplate("spec/roles/frontend-impl/prototype-to-production.md.txt");
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/templates/markdown/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;AAEtC;;GAEG;AACH,SAAS,iBAAiB,CAAC,QAAgB;IACzC,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAC3C,OAAO,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;AACzC,CAAC;AAED,gFAAgF;AAChF,8BAA8B;AAC9B,gFAAgF;AAEhF,MAAM,CAAC,MAAM,eAAe,GAAW,iBAAiB,CAAC,WAAW,CAAC,CAAC;AAEtE,oDAAoD;AACpD,MAAM,CAAC,MAAM,qBAAqB,GAChC,iBAAiB,CAAC,oBAAoB,CAAC,CAAC;AAE1C,gCAAgC;AAChC,MAAM,CAAC,MAAM,yBAAyB,GAAG,qBAAqB,CAAC;AAE/D,2DAA2D;AAC3D,MAAM,CAAC,MAAM,wBAAwB,GACnC,iBAAiB,CAAC,eAAe,CAAC,CAAC;AAErC,gFAAgF;AAChF,0DAA0D;AAC1D,wEAAwE;AACxE,gFAAgF;AAEhF,uCAAuC;AACvC,MAAM,CAAC,MAAM,mBAAmB,GAAW,iBAAiB,CAC1D,2BAA2B,CAC5B,CAAC;AACF,MAAM,CAAC,MAAM,gCAAgC,GAAW,iBAAiB,CACvE,yCAAyC,CAC1C,CAAC;AACF,MAAM,CAAC,MAAM,gCAAgC,GAAW,iBAAiB,CACvE,yCAAyC,CAC1C,CAAC;AACF,MAAM,CAAC,MAAM,+BAA+B,GAAW,iBAAiB,CACtE,wCAAwC,CACzC,CAAC;AACF,MAAM,CAAC,MAAM,+BAA+B,GAAW,iBAAiB,CACtE,wCAAwC,CACzC,CAAC;AACF,MAAM,CAAC,MAAM,2BAA2B,GAAW,iBAAiB,CAClE,oCAAoC,CACrC,CAAC;AAEF,wCAAwC;AACxC,MAAM,CAAC,MAAM,oBAAoB,GAAW,iBAAiB,CAC3D,4BAA4B,CAC7B,CAAC;AACF,MAAM,CAAC,MAAM,iCAAiC,GAAW,iBAAiB,CACxE,0CAA0C,CAC3C,CAAC;AACF,MAAM,CAAC,MAAM,yBAAyB,GAAW,iBAAiB,CAChE,kCAAkC,CACnC,CAAC;AACF,MAAM,CAAC,MAAM,6BAA6B,GAAW,iBAAiB,CACpE,sCAAsC,CACvC,CAAC;AACF,MAAM,CAAC,MAAM,kCAAkC,GAAW,iBAAiB,CACzE,2CAA2C,CAC5C,CAAC;AACF,MAAM,CAAC,MAAM,gCAAgC,GAAW,iBAAiB,CACvE,yCAAyC,CAC1C,CAAC;AACF,MAAM,CAAC,MAAM,8BAA8B,GAAW,iBAAiB,CACrE,uCAAuC,CACxC,CAAC;AAEF,mBAAmB;AACnB,MAAM,CAAC,MAAM,kBAAkB,GAAW,iBAAiB,CACzD,0BAA0B,CAC3B,CAAC;AACF,MAAM,CAAC,MAAM,oCAAoC,GAAW,iBAAiB,CAC3E,+CAA+C,CAChD,CAAC;AACF,MAAM,CAAC,MAAM,mCAAmC,GAAW,iBAAiB,CAC1E,8CAA8C,CAC/C,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/templates/markdown/index.ts"],"names":[],"mappings":"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"}

package/dist/templates/markdown/spec/roles/designer/index.md.txt

@@ -0,0 +1,57 @@
+# Designer Role Guidelines
+
+> Standards for interactive prototyping and mock data design.
+
+---
+
+## Overview
+
+This directory contains guidelines for the Designer role in the three-role collaboration pipeline. Fill in each file with your project's specific conventions.
+
+---
+
+## Guidelines Index
+
+| Guide | Description | Status |
+|-------|-------------|--------|
+| [Prototype Guidelines](./prototype-guidelines.md) | Component structure and interaction patterns | To fill |
+| [Mock Data Standards](./mock-data-standards.md) | How to create and document mock data | To fill |
+
+---
+
+## Workflow
+
+1. Pick a requirement from the pool: `/trellis:pick-task requirements <id>`
+2. Read the upstream HANDOFF.md and PRD carefully
+3. Create runnable prototype code in `deliverables/prototypes/<feature-id>/`
+4. Run `/trellis:handoff` to generate HANDOFF.md and add to pool
+5. Downstream Frontend developer picks from the `prototypes` pool
+
+---
+
+## Output Directory
+
+All Designer deliverables go to: `deliverables/prototypes/<feature-id>/`
+
+Required files:
+- Component files (`.tsx`, `.vue`, etc.) - runnable prototype code
+- Mock data inline or in separate files
+
+The prototype should:
+- Be runnable (renders correctly with mock data)
+- Follow the project's component conventions (see `spec/frontend/`)
+- Use clear `// TODO:` comments where real logic needs to be added
+- Document all mock data locations
+
+---
+
+## Key Principle
+
+> **The prototype IS the spec for Frontend.**
+>
+> Frontend developers should be able to run your prototype and understand
+> exactly what the final product should look like and behave like.
+
+---
+
+**Language**: All documentation should be written in **English**.

package/dist/templates/markdown/spec/roles/designer/mock-data-standards.md.txt

@@ -0,0 +1,63 @@
+# Mock Data Standards
+
+> How to create, document, and organize mock data in prototypes.
+
+---
+
+## Principles
+
+1. **Realistic**: Mock data should look like real data (realistic names, dates, amounts)
+2. **Documented**: Every mock data location must be clearly marked
+3. **Replaceable**: Mock data should be easy to find and replace with real API calls
+4. **Complete**: Cover all data states (populated, empty, error, boundary values)
+
+---
+
+## Mock Data Location
+
+Place mock data at the top of the component file or in a separate `__mocks__/` directory:
+
+```typescript
+// === MOCK DATA (start) ===
+const mockUser = {
+  id: "1",
+  name: "Alice Johnson",
+  email: "alice@example.com",
+  avatar: "https://i.pravatar.cc/150?u=alice",
+};
+
+const mockProducts = [
+  { id: "p1", name: "Widget A", price: 29.99, stock: 150 },
+  { id: "p2", name: "Widget B", price: 49.99, stock: 0 },
+];
+// === MOCK DATA (end) ===
+```
+
+---
+
+## Mock Handler Pattern
+
+```typescript
+// TODO: Replace with real API call - see api-integration.md
+const handleSubmit = async (formData: FormData) => {
+  // Mock: simulate network delay
+  await new Promise(resolve => setTimeout(resolve, 800));
+  // Mock: simulate success response
+  return { success: true, data: mockResponse };
+};
+```
+
+---
+
+## Edge Case Data
+
+Always include mock data for edge cases:
+- Empty list / no results
+- Single item
+- Maximum items (test scrolling/pagination)
+- Long text (test text overflow)
+- Missing optional fields
+
+---
+
+**Language**: All documentation should be written in **English**.

package/dist/templates/markdown/spec/roles/designer/prototype-guidelines.md.txt

@@ -0,0 +1,49 @@
+# Prototype Guidelines
+
+> Standards for creating interactive prototypes.
+
+---
+
+## Component Structure
+
+1. **One feature per directory**: Each feature prototype lives in its own directory
+2. **Entry point**: Always have a clear entry component (e.g., `FeaturePage.tsx`)
+3. **Component hierarchy**: Break down into logical sub-components
+4. **Shared components**: Use project's existing shared components when possible
+
+---
+
+## Interaction Patterns
+
+1. **All states**: Implement all UI states (loading, empty, error, success)
+2. **Animations**: Include transition animations if specified in PRD
+3. **Responsive**: Build mobile-first if the PRD requires responsive design
+4. **Accessibility**: Use semantic HTML, ARIA labels, keyboard navigation
+
+---
+
+## Code Conventions
+
+1. Follow the project's existing component patterns (see `spec/frontend/component-guidelines.md`)
+2. Use the project's styling approach (Tailwind, CSS modules, etc.)
+3. Keep components focused and single-purpose
+4. Add clear comments for complex interactions
+
+---
+
+## TODO Markers
+
+Mark all places where real implementation is needed:
+
+```typescript
+// TODO: Replace with real API call
+const data = mockData;
+
+// TODO: Add error handling
+// TODO: Implement loading state with skeleton
+// TODO: Connect to auth context
+```
+
+---
+
+**Language**: All documentation should be written in **English**.

package/dist/templates/markdown/spec/roles/frontend-impl/api-integration.md.txt

@@ -0,0 +1,63 @@
+# API Integration Guide
+
+> How to replace mock data and handlers with real API calls.
+
+---
+
+## Process
+
+### 1. Identify All Mock Points
+
+Search the prototype for:
+- `// TODO:` comments
+- `// Mock:` comments
+- `mock` variables and functions
+- `setTimeout` simulating API latency
+- Hardcoded data arrays/objects
+
+### 2. Map Mock to API
+
+For each mock point, determine:
+- Which API endpoint to call
+- Request format (method, headers, body)
+- Response format and how it maps to the component's expected data shape
+- Error responses and how to handle them
+
+### 3. Replace Pattern
+
+```typescript
+// BEFORE (mock):
+const handleLogin = async (email: string, password: string) => {
+  await new Promise(r => setTimeout(r, 800));
+  return { success: true, user: mockUser };
+};
+
+// AFTER (real):
+const handleLogin = async (email: string, password: string) => {
+  const response = await api.post('/auth/login', { email, password });
+  return response.data;
+};
+```
+
+---
+
+## Error Handling
+
+Every API call must handle:
+1. **Network errors**: Connection timeout, server unreachable
+2. **HTTP errors**: 4xx (client error), 5xx (server error)
+3. **Business errors**: Invalid credentials, insufficient permissions
+4. **Loading states**: Show loading indicator during request
+
+---
+
+## Testing
+
+- Test with real API responses
+- Test with simulated error responses
+- Test loading state transitions
+- Test retry behavior (if implemented)
+
+---
+
+**Language**: All documentation should be written in **English**.