@jahanxu/trellis 0.4.1 → 0.5.0

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

@@ -0,0 +1,57 @@
+# Frontend Implementation Role Guidelines
+
+> Standards for converting prototypes to production code.
+
+---
+
+## Overview
+
+This directory contains guidelines for the Frontend Implementation role in the three-role collaboration pipeline. Fill in each file with your project's specific conventions.
+
+---
+
+## Guidelines Index
+
+| Guide | Description | Status |
+|-------|-------------|--------|
+| [API Integration](./api-integration.md) | How to replace mock data with real APIs | To fill |
+| [Prototype to Production](./prototype-to-production.md) | Checklist for converting prototypes | To fill |
+
+---
+
+## Workflow
+
+1. Pick a prototype from the pool: `/trellis:pick-task prototypes <id>`
+2. Read the upstream HANDOFF.md carefully - it lists all TODOs
+3. Replace mock data with real API calls
+4. Add error handling, loading states, and edge case handling
+5. Write tests for critical paths
+6. Run `/trellis:handoff` to complete
+
+---
+
+## Output Directory
+
+Production code goes directly into the project source tree (e.g., `src/features/<feature>/`).
+
+A copy or reference is also placed in: `deliverables/production/<feature-id>/`
+
+---
+
+## Key Principle
+
+> **Preserve the prototype's UX, replace the data layer.**
+>
+> The Designer's prototype defines the look and interaction.
+> Your job is to make it work with real data and handle all edge cases.
+
+---
+
+## Also Read
+
+- `spec/frontend/` - Project frontend conventions (components, hooks, state management)
+- `spec/backend/` - API conventions (if applicable)
+
+---
+
+**Language**: All documentation should be written in **English**.

package/dist/templates/markdown/spec/roles/frontend-impl/prototype-to-production.md.txt

@@ -0,0 +1,57 @@
+# Prototype to Production Checklist
+
+> Step-by-step checklist for converting a Designer's prototype to production code.
+
+---
+
+## Pre-Implementation
+
+- [ ] Read HANDOFF.md thoroughly - note all "Logic for Frontend to Implement" items
+- [ ] Identify all mock data locations (search for `// TODO:`, `// Mock:`, `mock` prefix)
+- [ ] Review prototype component structure - decide what to keep vs refactor
+- [ ] Check if prototype components follow project conventions (if not, note adjustments)
+
+## Data Layer
+
+- [ ] Replace all mock data with API calls or store connections
+- [ ] Add proper TypeScript types for API responses
+- [ ] Implement data fetching hooks (or use existing patterns)
+- [ ] Add caching strategy if needed (React Query, SWR, etc.)
+
+## Error Handling
+
+- [ ] Add error boundaries for component-level errors
+- [ ] Handle API errors with user-friendly messages
+- [ ] Implement retry logic for transient failures
+- [ ] Add fallback UI for error states
+
+## State Management
+
+- [ ] Connect to global state (auth, theme, etc.) as needed
+- [ ] Implement form state management
+- [ ] Handle optimistic updates if applicable
+- [ ] Clean up state on unmount
+
+## UX Polish
+
+- [ ] Loading skeletons for async content
+- [ ] Smooth transitions between states
+- [ ] Keyboard navigation works correctly
+- [ ] Focus management for modals/dialogs
+
+## Testing
+
+- [ ] Unit tests for business logic
+- [ ] Integration tests for API interactions
+- [ ] Accessibility testing (screen reader, keyboard-only)
+
+## Final Check
+
+- [ ] All TODO comments from prototype are resolved
+- [ ] No mock data remains in production code
+- [ ] Lint and type check pass
+- [ ] Visual diff with prototype (should look identical)
+
+---
+
+**Language**: All documentation should be written in **English**.

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

@@ -0,0 +1,45 @@
+# PM (Product Manager) Role Guidelines
+
+> Standards for product requirements and feature specification.
+
+---
+
+## Overview
+
+This directory contains guidelines for the PM role in the three-role collaboration pipeline. Fill in each file with your project's specific conventions.
+
+---
+
+## Guidelines Index
+
+| Guide | Description | Status |
+|-------|-------------|--------|
+| [PRD Template](./prd-template.md) | Standard PRD structure and content requirements | To fill |
+| [Requirement Checklist](./requirement-checklist.md) | Quality checklist before handoff | To fill |
+
+---
+
+## Workflow
+
+1. Create a task with `/trellis:start`
+2. Write PRD and supporting documents in `deliverables/requirements/<feature-id>/`
+3. Run `/trellis:handoff` to generate HANDOFF.md and add to pool
+4. Downstream Designer picks from the `requirements` pool
+
+---
+
+## Output Directory
+
+All PM deliverables go to: `deliverables/requirements/<feature-id>/`
+
+Required files:
+- `prd.md` - Product requirements document
+
+Optional files:
+- `user-stories.md` - Detailed user stories
+- `wireframes/` - Low-fidelity wireframes
+- `acceptance-criteria.md` - Detailed acceptance criteria
+
+---
+
+**Language**: All documentation should be written in **English**.

package/dist/templates/markdown/spec/roles/pm/prd-template.md.txt

@@ -0,0 +1,64 @@
+# PRD Template
+
+> Standard structure for Product Requirements Documents.
+
+---
+
+## Template
+
+```markdown
+# Feature: {Feature Name}
+
+## Background
+Why this feature is needed. Business context and user pain points.
+
+## Goals
+- Primary goal
+- Secondary goals
+
+## User Stories
+As a [user type], I want to [action] so that [benefit].
+
+## Requirements
+
+### Functional Requirements
+1. ...
+2. ...
+
+### Non-Functional Requirements
+- Performance: ...
+- Security: ...
+- Accessibility: ...
+
+## UI/UX Requirements
+- Layout description
+- Key interactions
+- Error states
+
+## API Requirements (if applicable)
+- Endpoints needed
+- Data format expectations
+
+## Acceptance Criteria
+- [ ] Criterion 1
+- [ ] Criterion 2
+
+## Out of Scope
+- Items explicitly excluded from this feature
+
+## Open Questions
+- Questions that need resolution
+```
+
+---
+
+## Guidelines
+
+1. **Be specific**: Avoid vague language like "should be fast" - specify measurable criteria
+2. **Include edge cases**: Document what happens with empty data, errors, permission issues
+3. **Reference designs**: Link to Figma/mockups when available
+4. **Scope clearly**: Explicitly state what is NOT included
+
+---
+
+**Language**: All documentation should be written in **English**.

package/dist/templates/markdown/spec/roles/pm/requirement-checklist.md.txt

@@ -0,0 +1,43 @@
+# Requirement Checklist
+
+> Quality checklist before handing off requirements to the Designer.
+
+---
+
+## Pre-Handoff Checklist
+
+### Completeness
+- [ ] All user stories are written with clear acceptance criteria
+- [ ] Edge cases are documented (empty states, error states, loading states)
+- [ ] UI/UX requirements include layout descriptions and key interactions
+- [ ] API requirements are specified (if applicable)
+- [ ] Non-functional requirements are defined (performance, security, accessibility)
+
+### Clarity
+- [ ] No ambiguous language (e.g., "fast", "nice", "user-friendly" without metrics)
+- [ ] Technical constraints are explicitly stated
+- [ ] Out-of-scope items are listed
+- [ ] Open questions are resolved or explicitly deferred
+
+### Consistency
+- [ ] Feature aligns with existing product patterns
+- [ ] Naming conventions match existing features
+- [ ] No contradictions between requirements sections
+
+### Downstream Readiness
+- [ ] Designer can start prototyping without needing clarification meetings
+- [ ] All referenced resources (Figma links, API docs) are accessible
+- [ ] Priority and scope are clear
+
+---
+
+## Common Issues to Avoid
+
+1. **Missing error states**: Every user action should have a defined failure path
+2. **Implicit assumptions**: State all assumptions explicitly
+3. **Feature creep**: Keep scope tight - add "future considerations" for nice-to-haves
+4. **Missing data requirements**: Specify what data the UI needs and where it comes from
+
+---
+
+**Language**: All documentation should be written in **English**.

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

@@ -39,6 +39,7 @@ export declare const taskScript: string;
 export declare const getContextScript: string;
 export declare const addSessionScript: string;
 export declare const createBootstrapScript: string;
+export declare const poolScript: string;
 export declare const workflowMdTemplate: string;
 export declare const worktreeYamlTemplate: string;
 export declare const gitignoreTemplate: string;

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/templates/trellis/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAcH,eAAO,MAAM,WAAW,QAAsC,CAAC;AAG/D,eAAO,MAAM,UAAU,QAA6C,CAAC;AACrE,eAAO,MAAM,WAAW,QAA0C,CAAC;AACnE,eAAO,MAAM,eAAe,QAA8C,CAAC;AAC3E,eAAO,MAAM,gBAAgB,QAAgD,CAAC;AAC9E,eAAO,MAAM,cAAc,QAA6C,CAAC;AACzE,eAAO,MAAM,eAAe,QAA+C,CAAC;AAC5E,eAAO,MAAM,eAAe,QAA+C,CAAC;AAC5E,eAAO,MAAM,WAAW,QAA0C,CAAC;AACnE,eAAO,MAAM,cAAc,QAA6C,CAAC;AACzE,eAAO,MAAM,gBAAgB,QAAgD,CAAC;AAG9E,eAAO,MAAM,cAAc,QAAkD,CAAC;AAC9E,eAAO,MAAM,eAAe,QAA+C,CAAC;AAC5E,eAAO,MAAM,iBAAiB,QAAiD,CAAC;AAChF,eAAO,MAAM,gBAAgB,QAAgD,CAAC;AAC9E,eAAO,MAAM,kBAAkB,QAAmD,CAAC;AACnF,eAAO,MAAM,cAAc,QAA8C,CAAC;AAG1E,eAAO,MAAM,kBAAkB,QAA2C,CAAC;AAC3E,eAAO,MAAM,mBAAmB,QAA4C,CAAC;AAC7E,eAAO,MAAM,UAAU,QAAkC,CAAC;AAC1D,eAAO,MAAM,gBAAgB,QAAyC,CAAC;AACvE,eAAO,MAAM,gBAAgB,QAAyC,CAAC;AACvE,eAAO,MAAM,qBAAqB,QAA8C,CAAC;AAGjF,eAAO,MAAM,kBAAkB,QAA8B,CAAC;AAC9D,eAAO,MAAM,oBAAoB,QAAgC,CAAC;AAClE,eAAO,MAAM,iBAAiB,QAAgC,CAAC;AAE/D;;GAEG;AACH,wBAAgB,aAAa,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAmCnD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/templates/trellis/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAcH,eAAO,MAAM,WAAW,QAAsC,CAAC;AAG/D,eAAO,MAAM,UAAU,QAA6C,CAAC;AACrE,eAAO,MAAM,WAAW,QAA0C,CAAC;AACnE,eAAO,MAAM,eAAe,QAA8C,CAAC;AAC3E,eAAO,MAAM,gBAAgB,QAAgD,CAAC;AAC9E,eAAO,MAAM,cAAc,QAA6C,CAAC;AACzE,eAAO,MAAM,eAAe,QAA+C,CAAC;AAC5E,eAAO,MAAM,eAAe,QAA+C,CAAC;AAC5E,eAAO,MAAM,WAAW,QAA0C,CAAC;AACnE,eAAO,MAAM,cAAc,QAA6C,CAAC;AACzE,eAAO,MAAM,gBAAgB,QAAgD,CAAC;AAG9E,eAAO,MAAM,cAAc,QAAkD,CAAC;AAC9E,eAAO,MAAM,eAAe,QAA+C,CAAC;AAC5E,eAAO,MAAM,iBAAiB,QAAiD,CAAC;AAChF,eAAO,MAAM,gBAAgB,QAAgD,CAAC;AAC9E,eAAO,MAAM,kBAAkB,QAE9B,CAAC;AACF,eAAO,MAAM,cAAc,QAA8C,CAAC;AAG1E,eAAO,MAAM,kBAAkB,QAA2C,CAAC;AAC3E,eAAO,MAAM,mBAAmB,QAA4C,CAAC;AAC7E,eAAO,MAAM,UAAU,QAAkC,CAAC;AAC1D,eAAO,MAAM,gBAAgB,QAAyC,CAAC;AACvE,eAAO,MAAM,gBAAgB,QAAyC,CAAC;AACvE,eAAO,MAAM,qBAAqB,QAEjC,CAAC;AACF,eAAO,MAAM,UAAU,QAAkC,CAAC;AAG1D,eAAO,MAAM,kBAAkB,QAA8B,CAAC;AAC9D,eAAO,MAAM,oBAAoB,QAAgC,CAAC;AAClE,eAAO,MAAM,iBAAiB,QAAgC,CAAC;AAE/D;;GAEG;AACH,wBAAgB,aAAa,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAoCnD"}

package/dist/templates/trellis/index.js

@@ -51,6 +51,7 @@ export const taskScript = readTemplate("scripts/task.py");
 export const getContextScript = readTemplate("scripts/get_context.py");
 export const addSessionScript = readTemplate("scripts/add_session.py");
 export const createBootstrapScript = readTemplate("scripts/create_bootstrap.py");
+export const poolScript = readTemplate("scripts/pool.py");
 // Configuration files
 export const workflowMdTemplate = readTemplate("workflow.md");
 export const worktreeYamlTemplate = readTemplate("worktree.yaml");
@@ -87,6 +88,7 @@ export function getAllScripts() {
     scripts.set("get_context.py", getContextScript);
     scripts.set("add_session.py", addSessionScript);
     scripts.set("create_bootstrap.py", createBootstrapScript);
+    scripts.set("pool.py", poolScript);
     return scripts;
 }
 //# sourceMappingURL=index.js.map

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

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

package/dist/templates/trellis/scripts/add_session.py

@@ -8,6 +8,7 @@ Usage:
     echo "content" | python3 add_session.py --title "Title" --commit "hash"
 """
 
+from __future__ import annotations
 
 import sys
 
@@ -42,13 +43,13 @@ MAX_LINES = 2000
 # Helper Functions
 # =============================================================================
 
-def get_latest_journal_info(dev_dir: Path) -> tuple[Optional[Path], int, int]:
+def get_latest_journal_info(dev_dir: Path) -> tuple[Path | None, int, int]:
     """Get latest journal file info.
 
     Returns:
         Tuple of (file_path, file_number, line_count).
     """
-    latest_file: Optional[Path] = None
+    latest_file: Path | None = None
     latest_num = -1
 
     for f in dev_dir.glob(f"{FILE_JOURNAL_PREFIX}*.md"):

package/dist/templates/trellis/scripts/common/cli_adapter.py

@@ -25,6 +25,7 @@ Usage:
     )
 """
 
+from __future__ import annotations
 
 from dataclasses import dataclass
 from pathlib import Path
@@ -215,7 +216,7 @@ class CLIAdapter:
         self,
         agent: str,
         prompt: str,
-        session_id: Optional[str] = None,
+        session_id: str | None = None,
         skip_permissions: bool = True,
         verbose: bool = True,
         json_output: bool = True,
@@ -311,7 +312,7 @@ class CLIAdapter:
         else:
             return ["claude", "--resume", session_id]
 
-    def get_resume_command_str(self, session_id: str, cwd: Optional[str] = None) -> str:
+    def get_resume_command_str(self, session_id: str, cwd: str | None = None) -> str:
         """Get human-readable resume command string.
 
         Args:
@@ -388,7 +389,7 @@ class CLIAdapter:
         """
         return self.platform == "claude"
 
-    def extract_session_id_from_log(self, log_content: str) -> Optional[str]:
+    def extract_session_id_from_log(self, log_content: str) -> str | None:
         """Extract session ID from log output (OpenCode only).
 
         OpenCode generates session IDs in format: ses_xxx

package/dist/templates/trellis/scripts/common/developer.py

@@ -8,6 +8,7 @@ Provides:
     show_developer_info - Show developer information
 """
 
+from __future__ import annotations
 
 import sys
 from datetime import datetime
@@ -29,7 +30,7 @@ from .paths import (
 # Developer Initialization
 # =============================================================================
 
-def init_developer(name: str, repo_root: Optional[Path] = None) -> bool:
+def init_developer(name: str, repo_root: Path | None = None) -> bool:
     """Initialize developer.
 
     Creates:
@@ -147,7 +148,7 @@ def init_developer(name: str, repo_root: Optional[Path] = None) -> bool:
     return True
 
 
-def ensure_developer(repo_root: Optional[Path] = None) -> None:
+def ensure_developer(repo_root: Path | None = None) -> None:
     """Ensure developer is initialized, exit if not.
 
     Args:
@@ -162,7 +163,7 @@ def ensure_developer(repo_root: Optional[Path] = None) -> None:
         sys.exit(1)
 
 
-def show_developer_info(repo_root: Optional[Path] = None) -> None:
+def show_developer_info(repo_root: Path | None = None) -> None:
     """Show developer information.
 
     Args:

package/dist/templates/trellis/scripts/common/git_context.py

@@ -8,6 +8,7 @@ Provides:
     output_text - Output context in text format
 """
 
+from __future__ import annotations
 
 import sys
 
@@ -23,7 +24,6 @@ if sys.platform == "win32":
 import json
 import subprocess
 from pathlib import Path
-from typing import Optional
 
 from .paths import (
     DIR_SCRIPTS,
@@ -45,7 +45,7 @@ from .paths import (
 # =============================================================================
 
 
-def _run_git_command(args: list[str], cwd: Optional[Path] = None) -> tuple[int, str, str]:
+def _run_git_command(args: list[str], cwd: Path | None = None) -> tuple[int, str, str]:
     """Run a git command and return (returncode, stdout, stderr).
 
     Uses UTF-8 encoding with -c i18n.logOutputEncoding=UTF-8 to ensure
@@ -67,7 +67,7 @@ def _run_git_command(args: list[str], cwd: Optional[Path] = None) -> tuple[int,
         return 1, "", str(e)
 
 
-def _read_json_file(path: Path) -> Optional[dict]:
+def _read_json_file(path: Path) -> dict | None:
     """Read and parse a JSON file."""
     try:
         return json.loads(path.read_text(encoding="utf-8"))
@@ -80,7 +80,7 @@ def _read_json_file(path: Path) -> Optional[dict]:
 # =============================================================================
 
 
-def get_context_json(repo_root: Optional[Path] = None) -> dict:
+def get_context_json(repo_root: Path | None = None) -> dict:
     """Get context as a dictionary.
 
     Args:
@@ -160,7 +160,7 @@ def get_context_json(repo_root: Optional[Path] = None) -> dict:
     }
 
 
-def output_json(repo_root: Optional[Path] = None) -> None:
+def output_json(repo_root: Path | None = None) -> None:
     """Output context in JSON format.
 
     Args:
@@ -175,7 +175,7 @@ def output_json(repo_root: Optional[Path] = None) -> None:
 # =============================================================================
 
 
-def get_context_text(repo_root: Optional[Path] = None) -> str:
+def get_context_text(repo_root: Path | None = None) -> str:
     """Get context as formatted text.
 
     Args:
@@ -345,7 +345,7 @@ def get_context_text(repo_root: Optional[Path] = None) -> str:
     return "\n".join(lines)
 
 
-def output_text(repo_root: Optional[Path] = None) -> None:
+def output_text(repo_root: Path | None = None) -> None:
     """Output context in text format.
 
     Args:

package/dist/templates/trellis/scripts/common/paths.py

@@ -10,10 +10,11 @@ Provides:
     get_active_journal_file - Get current journal file
 """
 
+from __future__ import annotations
+
 import re
 from datetime import datetime
 from pathlib import Path
-from typing import Optional
 
 
 # =============================================================================
@@ -27,19 +28,23 @@ DIR_TASKS = "tasks"
 DIR_ARCHIVE = "archive"
 DIR_SPEC = "spec"
 DIR_SCRIPTS = "scripts"
+DIR_POOL = "pool"
+DIR_DELIVERABLES = "deliverables"
 
 # File names
 FILE_DEVELOPER = ".developer"
 FILE_CURRENT_TASK = ".current-task"
 FILE_TASK_JSON = "task.json"
 FILE_JOURNAL_PREFIX = "journal-"
+FILE_SOURCE_JSON = "source.json"
+FILE_HANDOFF_MD = "HANDOFF.md"
 
 
 # =============================================================================
 # Repository Root
 # =============================================================================
 
-def get_repo_root(start_path: Optional[Path] = None) -> Path:
+def get_repo_root(start_path: Path | None = None) -> Path:
     """Find the nearest directory containing .trellis/ folder.
 
     This handles nested git repos correctly (e.g., test project inside another repo).
@@ -65,7 +70,7 @@ def get_repo_root(start_path: Optional[Path] = None) -> Path:
 # Developer
 # =============================================================================
 
-def get_developer(repo_root: Optional[Path] = None) -> Optional[str]:
+def get_developer(repo_root: Path | None = None) -> str | None:
     """Get developer name from .developer file.
 
     Args:
@@ -93,7 +98,7 @@ def get_developer(repo_root: Optional[Path] = None) -> Optional[str]:
     return None
 
 
-def check_developer(repo_root: Optional[Path] = None) -> bool:
+def check_developer(repo_root: Path | None = None) -> bool:
     """Check if developer is initialized.
 
     Args:
@@ -109,7 +114,7 @@ def check_developer(repo_root: Optional[Path] = None) -> bool:
 # Tasks Directory
 # =============================================================================
 
-def get_tasks_dir(repo_root: Optional[Path] = None) -> Path:
+def get_tasks_dir(repo_root: Path | None = None) -> Path:
     """Get tasks directory path.
 
     Args:
@@ -127,7 +132,7 @@ def get_tasks_dir(repo_root: Optional[Path] = None) -> Path:
 # Workspace Directory
 # =============================================================================
 
-def get_workspace_dir(repo_root: Optional[Path] = None) -> Optional[Path]:
+def get_workspace_dir(repo_root: Path | None = None) -> Path | None:
     """Get developer workspace directory.
 
     Args:
@@ -149,7 +154,7 @@ def get_workspace_dir(repo_root: Optional[Path] = None) -> Optional[Path]:
 # Journal File
 # =============================================================================
 
-def get_active_journal_file(repo_root: Optional[Path] = None) -> Optional[Path]:
+def get_active_journal_file(repo_root: Path | None = None) -> Path | None:
     """Get the current active journal file.
 
     Args:
@@ -165,7 +170,7 @@ def get_active_journal_file(repo_root: Optional[Path] = None) -> Optional[Path]:
     if workspace_dir is None or not workspace_dir.is_dir():
         return None
 
-    latest: Optional[Path] = None
+    latest: Path | None = None
     highest = 0
 
     for f in workspace_dir.glob(f"{FILE_JOURNAL_PREFIX}*.md"):
@@ -206,7 +211,7 @@ def count_lines(file_path: Path) -> int:
 # Current Task Management
 # =============================================================================
 
-def _get_current_task_file(repo_root: Optional[Path] = None) -> Path:
+def _get_current_task_file(repo_root: Path | None = None) -> Path:
     """Get .current-task file path.
 
     Args:
@@ -220,7 +225,7 @@ def _get_current_task_file(repo_root: Optional[Path] = None) -> Path:
     return repo_root / DIR_WORKFLOW / FILE_CURRENT_TASK
 
 
-def get_current_task(repo_root: Optional[Path] = None) -> Optional[str]:
+def get_current_task(repo_root: Path | None = None) -> str | None:
     """Get current task directory path (relative to repo_root).
 
     Args:
@@ -240,7 +245,7 @@ def get_current_task(repo_root: Optional[Path] = None) -> Optional[str]:
         return None
 
 
-def get_current_task_abs(repo_root: Optional[Path] = None) -> Optional[Path]:
+def get_current_task_abs(repo_root: Path | None = None) -> Path | None:
     """Get current task directory absolute path.
 
     Args:
@@ -258,7 +263,7 @@ def get_current_task_abs(repo_root: Optional[Path] = None) -> Optional[Path]:
     return None
 
 
-def set_current_task(task_path: str, repo_root: Optional[Path] = None) -> bool:
+def set_current_task(task_path: str, repo_root: Path | None = None) -> bool:
     """Set current task.
 
     Args:
@@ -288,7 +293,7 @@ def set_current_task(task_path: str, repo_root: Optional[Path] = None) -> bool:
         return False
 
 
-def clear_current_task(repo_root: Optional[Path] = None) -> bool:
+def clear_current_task(repo_root: Path | None = None) -> bool:
     """Clear current task.
 
     Args:
@@ -307,7 +312,7 @@ def clear_current_task(repo_root: Optional[Path] = None) -> bool:
         return False
 
 
-def has_current_task(repo_root: Optional[Path] = None) -> bool:
+def has_current_task(repo_root: Path | None = None) -> bool:
     """Check if has current task.
 
     Args:
@@ -319,6 +324,51 @@ def has_current_task(repo_root: Optional[Path] = None) -> bool:
     return get_current_task(repo_root) is not None
 
 
+# =============================================================================
+# Pool Directory
+# =============================================================================
+
+def get_pool_dir(repo_root: Path | None = None) -> Path:
+    """Get pool directory path.
+
+    Args:
+        repo_root: Repository root path. Defaults to auto-detected.
+
+    Returns:
+        Path to pool directory.
+    """
+    if repo_root is None:
+        repo_root = get_repo_root()
+    return repo_root / DIR_WORKFLOW / DIR_POOL
+
+
+def get_pool_file(pool_name: str, repo_root: Path | None = None) -> Path:
+    """Get pool JSON file path.
+
+    Args:
+        pool_name: Pool name (e.g., 'requirements').
+        repo_root: Repository root path. Defaults to auto-detected.
+
+    Returns:
+        Path to pool JSON file.
+    """
+    return get_pool_dir(repo_root) / f"{pool_name}.json"
+
+
+def get_deliverables_dir(repo_root: Path | None = None) -> Path:
+    """Get deliverables directory path (at project root).
+
+    Args:
+        repo_root: Repository root path. Defaults to auto-detected.
+
+    Returns:
+        Path to deliverables directory.
+    """
+    if repo_root is None:
+        repo_root = get_repo_root()
+    return repo_root / DIR_DELIVERABLES
+
+
 # =============================================================================
 # Task ID Generation
 # =============================================================================