mirror of
https://github.com/catlog22/Claude-Code-Workflow.git
synced 2026-03-01 09:33:25 +08:00
feat: add templates for epics, product brief, and requirements PRD
- Created a new directory structure for epics and stories with templates for individual epics and an index file. - Added a product brief template for generating product brief documents in Phase 2. - Introduced a requirements PRD template for generating a Product Requirements Document as a directory of individual requirement files in Phase 3. feat: implement V2PipelineTab component for Memory V2 management - Developed the V2PipelineTab component to manage extraction and consolidation processes. - Included ExtractionCard and ConsolidationCard components to handle respective functionalities. - Added JobsList component to display job statuses and allow filtering by job kind. feat: create hooks for Memory V2 pipeline - Implemented custom hooks for managing extraction and consolidation statuses, as well as job listings. - Added mutation hooks to trigger extraction and consolidation processes with automatic query invalidation on success.
This commit is contained in:
catlog22
205
.codex/skills/team-lifecycle/phases/02-team-initialization.md
Normal file
205
.codex/skills/team-lifecycle/phases/02-team-initialization.md
Normal file
@@ -0,0 +1,205 @@
|
||||
# Phase 2: Team Initialization
|
||||
|
||||
> **COMPACT PROTECTION**: This is an execution document. After context compression, phase instructions become summaries only. You MUST immediately re-read this file via `Read("~/.codex/skills/team-lifecycle/phases/02-team-initialization.md")` before continuing. Never execute based on summaries.
|
||||
|
||||
## Objective
|
||||
|
||||
Create the session directory structure, initialize the state file (`team-session.json`), set up wisdom and exploration cache directories. No agents are spawned in this phase.
|
||||
|
||||
---
|
||||
|
||||
## Input
|
||||
|
||||
| Input | Source | Required |
|
||||
|-------|--------|----------|
|
||||
| requirements | Phase 1 output | Yes |
|
||||
| requirements.mode | Finalized pipeline mode | Yes |
|
||||
| requirements.scope | Project scope description | Yes |
|
||||
| requirements.execution | sequential or parallel | Yes |
|
||||
| Project root | Current working directory | Yes |
|
||||
|
||||
---
|
||||
|
||||
## Execution Steps
|
||||
|
||||
### Step 2.1: Generate Session ID
|
||||
|
||||
```javascript
|
||||
// Generate slug from scope description (max 20 chars, kebab-case)
|
||||
const slug = requirements.scope
|
||||
.toLowerCase()
|
||||
.replace(/[^a-z0-9]+/g, '-')
|
||||
.replace(/^-|-$/g, '')
|
||||
.slice(0, 20)
|
||||
|
||||
// Date in YYYY-MM-DD format
|
||||
const date = new Date().toISOString().slice(0, 10)
|
||||
|
||||
const sessionId = `TLS-${slug}-${date}`
|
||||
const sessionDir = `.workflow/.team/${sessionId}`
|
||||
```
|
||||
|
||||
### Step 2.2: Create Directory Structure
|
||||
|
||||
```bash
|
||||
mkdir -p "<session-dir>/spec/requirements"
|
||||
mkdir -p "<session-dir>/spec/architecture"
|
||||
mkdir -p "<session-dir>/spec/epics"
|
||||
mkdir -p "<session-dir>/discussions"
|
||||
mkdir -p "<session-dir>/plan/tasks"
|
||||
mkdir -p "<session-dir>/explorations"
|
||||
mkdir -p "<session-dir>/architecture"
|
||||
mkdir -p "<session-dir>/analysis"
|
||||
mkdir -p "<session-dir>/qa"
|
||||
mkdir -p "<session-dir>/wisdom"
|
||||
```
|
||||
|
||||
**Directory purpose reference**:
|
||||
|
||||
| Directory | Purpose | Written By |
|
||||
|-----------|---------|-----------|
|
||||
| spec/ | Specification artifacts (briefs, PRDs, architecture, epics) | analyst, writer |
|
||||
| discussions/ | Discussion records from inline discuss subagent | discuss subagent |
|
||||
| plan/ | Implementation plan and task breakdown | planner |
|
||||
| explorations/ | Shared codebase exploration cache | explore subagent |
|
||||
| architecture/ | Architect assessments, design tokens | architect |
|
||||
| analysis/ | Analyst design intelligence (UI mode) | analyst |
|
||||
| qa/ | QA audit reports | fe-qa |
|
||||
| wisdom/ | Cross-task knowledge accumulation | all agents |
|
||||
|
||||
### Step 2.3: Initialize Wisdom Directory
|
||||
|
||||
Create the four wisdom files with empty starter content:
|
||||
|
||||
```javascript
|
||||
// learnings.md
|
||||
Write("<session-dir>/wisdom/learnings.md",
|
||||
"# Learnings\n\nPatterns and insights discovered during this session.\n")
|
||||
|
||||
// decisions.md
|
||||
Write("<session-dir>/wisdom/decisions.md",
|
||||
"# Decisions\n\nArchitecture and design decisions made during this session.\n")
|
||||
|
||||
// conventions.md
|
||||
Write("<session-dir>/wisdom/conventions.md",
|
||||
"# Conventions\n\nCodebase conventions identified during this session.\n")
|
||||
|
||||
// issues.md
|
||||
Write("<session-dir>/wisdom/issues.md",
|
||||
"# Issues\n\nKnown risks and issues flagged during this session.\n")
|
||||
```
|
||||
|
||||
### Step 2.4: Initialize Explorations Cache
|
||||
|
||||
```javascript
|
||||
Write("<session-dir>/explorations/cache-index.json",
|
||||
JSON.stringify({ entries: [] }, null, 2))
|
||||
```
|
||||
|
||||
### Step 2.5: Initialize Shared Memory
|
||||
|
||||
```javascript
|
||||
Write("<session-dir>/shared-memory.json",
|
||||
JSON.stringify({
|
||||
design_intelligence: null,
|
||||
design_token_registry: null,
|
||||
component_inventory: null,
|
||||
style_decisions: null,
|
||||
qa_history: null,
|
||||
industry_context: null,
|
||||
exploration_cache: null
|
||||
}, null, 2))
|
||||
```
|
||||
|
||||
### Step 2.6: Determine Task Counts
|
||||
|
||||
Compute expected task counts based on mode:
|
||||
|
||||
| Mode | Tasks | Pipeline Composition |
|
||||
|------|-------|---------------------|
|
||||
| spec-only | 6 | Spec pipeline (6) |
|
||||
| impl-only | 4 | Impl pipeline (4) |
|
||||
| fe-only | 3 | FE pipeline (3) + possible GC loop tasks |
|
||||
| fullstack | 6 | Fullstack pipeline (6) |
|
||||
| full-lifecycle | 10 | Spec (6) + Impl (4) |
|
||||
| full-lifecycle-fe | 12 | Spec (6) + Fullstack (6) + possible GC loop tasks |
|
||||
|
||||
### Step 2.7: Write State File (team-session.json)
|
||||
|
||||
```javascript
|
||||
const state = {
|
||||
session_id: sessionId,
|
||||
mode: requirements.mode,
|
||||
scope: requirements.scope,
|
||||
focus: requirements.focus || [],
|
||||
depth: requirements.depth || "normal",
|
||||
execution: requirements.execution || "parallel",
|
||||
status: "active",
|
||||
started_at: new Date().toISOString(),
|
||||
updated_at: new Date().toISOString(),
|
||||
tasks_total: taskCount, // from Step 2.6
|
||||
tasks_completed: 0,
|
||||
pipeline: [], // populated in Phase 3
|
||||
active_agents: [],
|
||||
completed_tasks: [],
|
||||
revision_chains: {},
|
||||
wisdom_entries: [],
|
||||
checkpoints_hit: [],
|
||||
gc_loop_count: 0,
|
||||
frontend_detected: requirements.frontend_detected || false,
|
||||
spec_path: requirements.spec_path || null,
|
||||
raw_input: requirements.raw_input
|
||||
}
|
||||
|
||||
Write("<session-dir>/team-session.json",
|
||||
JSON.stringify(state, null, 2))
|
||||
```
|
||||
|
||||
### Step 2.8: Output Confirmation
|
||||
|
||||
```
|
||||
[orchestrator] Phase 2: Session initialized
|
||||
Session ID: <session-id>
|
||||
Session directory: <session-dir>
|
||||
Mode: <mode> (<task-count> tasks)
|
||||
Scope: <scope-summary>
|
||||
Execution: <sequential | parallel>
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Output
|
||||
|
||||
| Output | Type | Destination |
|
||||
|--------|------|-------------|
|
||||
| sessionId | String | Passed to Phase 3 |
|
||||
| sessionDir | String | Passed to Phase 3 |
|
||||
| state | Object | Written to team-session.json, passed to Phase 3 |
|
||||
|
||||
---
|
||||
|
||||
## Success Criteria
|
||||
|
||||
- Session directory created with all subdirectories
|
||||
- Wisdom files initialized (4 files)
|
||||
- Explorations cache-index.json created (empty entries)
|
||||
- Shared-memory.json created
|
||||
- team-session.json written with correct mode, scope, task count
|
||||
- State file is valid JSON and readable
|
||||
|
||||
---
|
||||
|
||||
## Error Handling
|
||||
|
||||
| Error | Resolution |
|
||||
|-------|------------|
|
||||
| Directory already exists with same session ID | Append random suffix to slug to ensure uniqueness |
|
||||
| Write permission denied | Report error, suggest alternative directory |
|
||||
| Disk space insufficient | Report error, suggest cleanup |
|
||||
| Invalid mode in requirements | Should not happen (Phase 1 validates), but fail with message |
|
||||
|
||||
---
|
||||
|
||||
## Next Phase
|
||||
|
||||
Proceed to [Phase 3: Task Chain Creation](03-task-chain-creation.md) with `sessionId`, `sessionDir`, and `state`.
|
||||
Reference in New Issue
Block a user