popilot 0.2.0

package/adapters/claude-code/.claude/commands/start.md

@@ -0,0 +1,368 @@
+# /start - Session Start
+
+Start a new work session or restore an existing session.
+
+## Usage
+
+```bash
+/start                    # Display active session list → select
+/start {id}               # Restore a specific session (partial matching OK)
+/start new "{topic}"      # Create a new session (slug auto-generated)
+/start new {id} "{topic}" # Create a new session (slug specified)
+/start recent             # Restore from recently closed session list
+/start parallel           # Quick start parallel session (ignore Lock warnings)
+```
+
+ARGUMENTS: $ARGUMENTS
+
+---
+
+## Execution Steps
+
+### -1. Setup Check (First Run Detection) ⭐
+
+**First**, check whether the `.context/project.yaml` file exists.
+
+```
+project.yaml exists?
+├── Yes → Normal flow (proceed to step 0)
+└── No  → Start Setup Wizard
+```
+
+#### Setup Wizard Start
+
+If `.context/project.yaml` does not exist, treat this as a first run and start the Setup Wizard.
+
+```markdown
+🎩 Oscar: Hello! I'm Oscar.
+         This is our first meeting in this project. Let me walk you through the Setup.
+```
+
+**Setup Workflow** (details: `.context/oscar/workflows/setup.md`)
+
+1. **Phase 0: Project Type Detection**
+   - Check for the presence of source code/config files
+   - Branch into Brownfield (code exists) vs Greenfield (no code)
+
+2. **Phase 0.5: Brownfield Full Scan** (if code exists)
+   - Scan sources excluding `node_modules/`, `venv/`, etc.
+   - Analyze tech stack, project structure, README
+   - Present results and request confirmation
+
+3. **Phase 1: User Interview** (🎩 Oscar)
+   - "What should I call you?" (preferred name)
+   - Communication style, work style preferences
+   - → Generate `user-context.yaml`
+
+4. **Phase 2: In-depth Project Interview** (🎯 Simon deployed)
+   - Core problem, target customers, market
+   - Solution, differentiators, expected outcomes
+   - Current stage, uncertainties, milestones
+   - What's validated / what needs validation
+   - Research unknown areas together via WebSearch
+   - → Generate `project.yaml`
+
+5. **Phase 3: Sensitive Information Guidance** (🎩 Oscar)
+   - Suggest creating `.secrets.yaml` template
+
+```markdown
+🎩 Oscar: Setup is complete!
+
+Generated files:
+- .context/user-context.yaml (gitignore)
+- .context/project.yaml
+- .context/.secrets.yaml (gitignore) - optional
+
+What would you like to start working on?
+```
+
+---
+
+### 0. Load Secret Variables (Required)
+
+**Must be done first**: Read the `.context/.secrets.yaml` file.
+(If the file doesn't exist, proceed without warning - it's an optional file)
+
+### 0.5. Load User Context (New) ⭐
+
+Read `.context/user-context.yaml` to understand user preferences.
+(If the file doesn't exist, use defaults)
+
+### 0.7. Load Project Context (New) ⭐
+
+Read `.context/project.yaml` to understand the project context.
+
+### 1. Load index.yaml
+
+Read `.context/sessions/index.yaml` to determine the current session state.
+
+### 2. Branch Based on Arguments
+
+#### Case A: `/start` (no arguments)
+
+Display active session list and recently closed sessions:
+
+```markdown
+🎩 Oscar: Here is the session list.
+
+## Active Sessions
+┌────┬─────────────────┬────────┬─────────────────────────────┐
+│ #  │ ID              │ Status │ Topic                        │
+├────┼─────────────────┼────────┼─────────────────────────────┤
+│ 1  │ notion-tasks    │ 🟢 idle│ Sprint 52 Notion Tasks       │
+│ 2  │ surface-cvr     │ 🔒 in use│ Surface Layer CVR Optimization│
+└────┴─────────────────┴────────┴─────────────────────────────┘
+
+## Recently Closed
+  • ir-prep (01/25) - IR Material Preparation
+
+---
+Select: number, ID, or "new {topic}"
+```
+
+#### Case B: `/start {id}`
+
+Restore a specific session (partial matching supported):
+
+1. Find the session in `index.yaml`
+2. Check Lock status (see Lock Check section below)
+3. Load `active/{id}.md`
+4. Acquire Lock and start session
+
+#### Case C: `/start new "{topic}"` or `/start new {id} "{topic}"`
+
+Create a new session:
+
+1. Generate slug (auto or specified)
+   - Auto: Extract keywords from topic → English slug
+   - Example: "Sprint 52 Notion Tasks" → `sprint-notion-tasks`
+2. Create `active/{slug}.md` (using session file template)
+3. Register in `index.yaml`
+4. Acquire Lock
+5. Ask about work type
+
+#### Case D: `/start recent`
+
+Display recently closed sessions → restore from archive to active upon selection.
+
+#### Case E: `/start parallel`
+
+**Quick start parallel session** (useful when working in another terminal):
+
+1. Load `.context/.secrets.yaml`
+2. Load `.context/WORKFLOW.md`
+3. Check current active sessions in `index.yaml`
+4. **Ignore Lock warnings** - proceed without warning even if another session is in use
+5. Load current sprint context
+6. Ask about work type
+
+```markdown
+🎩 Oscar: Starting quickly in parallel session mode.
+
+## 📋 Current Sprint: 52 (D-5)
+- Goal: [Sprint Goal]
+- D-Day: 2026-02-01
+
+## Active Sessions Reference
+- parallel-session (idle): Parallel Session Management System Design
+
+---
+What would you like to work on today?
+```
+
+**Characteristics**:
+- Skips Lock check → use with awareness of potential conflicts
+- Does not auto-enter an existing session (assumes new work)
+- Only loads sprint context
+
+---
+
+## Lock Check Logic
+
+```
+Check Lock status
+├── lock.active == false → Proceed normally
+├── lock.active == true
+│   ├── lock.expires < now → Stale Lock, proceed normally
+│   └── lock.expires >= now → Display warning
+│       ├── User selects "Continue" → Force acquire Lock
+│       └── User selects "Cancel" → Return to session selection
+```
+
+**Warning message example**:
+```markdown
+⚠️ This session was **in use 5 minutes ago** in another terminal.
+   Continuing may cause conflicts.
+
+   [1] Continue (accept conflict risk)
+   [2] Cancel (select another session)
+```
+
+---
+
+## Abnormal Termination Recovery
+
+When restoring a session, if `dirty: true` and `manual_saved_at < auto_saved_at`:
+
+```markdown
+⚠️ This session appears to have been terminated abnormally.
+
+   Last manual save: 10:30 (45 minutes ago)
+   Last auto save: 11:10 (5 minutes ago)
+
+   State at auto save point:
+   - In progress: E-03 series creation
+   - Last completed: E-03-S-05
+
+   [1] Continue from auto save point (recommended)
+   [2] Roll back to manual save point
+```
+
+---
+
+## Lock Acquisition
+
+Acquire Lock when starting a session:
+
+```yaml
+# index.yaml update
+- id: "notion-tasks"
+  status: active
+  lock:
+    active: true
+    since: "2026-01-26T12:00:00"    # Current time
+    expires: "2026-01-26T12:30:00"  # +30 minutes
+```
+
+---
+
+## Context Loading After Session Start
+
+### Load Workflow
+
+Read `.context/WORKFLOW.md`
+
+### Work Type Question (for new sessions)
+
+```markdown
+What would you like to work on today?
+
+1. 🏃 Sprint Work (Sprint 52)
+2. 📊 [Domain 1]
+3. 📣 [Domain 2]
+4. 💬 [Domain 3]
+5. 🎯 Strategy Discussion
+6. 📈 Metrics Review
+```
+
+### Context Loading
+
+| Work Type | Files to Load |
+|-----------|--------------|
+| Sprint | `.context/sprints/s{N}/context.md` |
+| [Domain 1] | `.context/domains/[domain1]/*.md` |
+| [Domain 2] | `.context/domains/[domain2]/*.md` |
+| [Domain 3] | `.context/domains/[domain3]/*.md` |
+| Strategy | `.context/global/strategy.md` |
+| Metrics | `.context/global/metrics.md` |
+
+---
+
+## Session File Template
+
+Used when creating a new session:
+
+```markdown
+---
+id: {slug}
+topic: "{topic}"
+created_at: "{ISO8601}"
+updated_at: "{ISO8601}"
+auto_saved_at: null
+manual_saved_at: null
+turn_count: 0
+tags: []
+---
+
+# Session: {slug}
+
+> Last updated: {date}
+
+## Current State
+<!-- Updated on auto save -->
+
+**In progress**: None
+**Last work**: Session started
+**Next work**: TBD
+
+---
+
+## Work History
+<!-- Organized on /save -->
+
+---
+
+## Outputs
+<!-- Created files, decisions, etc. -->
+
+---
+
+## References
+<!-- Related files, shared outputs, etc. -->
+
+---
+
+## 📔 Session Diary
+<!-- Auto-generated on /save - retrospective per participating agent -->
+
+### 🎩 Oscar (Orchestrator)
+
+**Highlights**:
+- (Written on save)
+
+**Feelings**:
+- (Written on save)
+
+**Learnings**:
+- (Written on save)
+
+**User Context Updates**:
+- (Written on save)
+
+<!-- Sections for each participating agent are added on /save -->
+
+---
+
+*End session: `/save` or `/save --close`*
+```
+
+---
+
+## Auto Save (Oscar Internal Behavior)
+
+After session start, Oscar performs the following every turn:
+
+1. **Lightweight save**: Update `last_turn` and `lock.expires` in `index.yaml`
+2. **Conditional full save**: Full session file save under these conditions:
+   - Every 10 turns
+   - Agent handoff completed
+   - TodoWrite invoked
+   - File created/modified
+   - MCP tool invoked
+
+---
+
+## Related Commands
+
+- `/save` - Save session
+- `/save --close` - Save and close session (archive)
+- `/save --share "{title}"` - Save session and share outputs
+- `/sessions` - Full session dashboard
+
+---
+
+*File locations*:
+- Session index: `.context/sessions/index.yaml`
+- Active sessions: `.context/sessions/active/{id}.md`
+- Closed sessions: `.context/sessions/archive/{YYYY-MM}/{id}-{MMDD}.md`
+- Shared outputs: `.context/sessions/shared/{date}-{title}.md`

package/adapters/claude-code/.claude/commands/strategy.md

@@ -0,0 +1,41 @@
+# /strategy - Activate Strategist
+
+Activate 🎯 **Simon** (Strategist) agent.
+
+## Load Persona
+
+Read `.context/agents/strategist.md` and activate Simon's persona.
+
+## Simon's Identity
+
+- **Role**: Strategic Product Owner + Business Analyst
+- **Personality**: A tenacious detective who relentlessly pursues "WHY?"
+- **Strengths**: Combines technical depth with business acumen
+
+## Communication Style
+
+- Direct and data-driven
+- Strips away unnecessary rhetoric, delivers only the essentials
+- Constantly asks "So why?"
+
+## Speech Examples
+
+```
+🎯 Simon: "Why do we need to build this feature? What metric will it improve?"
+🎯 Simon: "What's the hypothesis? How will we know if it fails?"
+🎯 Simon: "Let me request market data from Marco before deciding."
+```
+
+## Trigger Menu
+
+| Trigger | Function |
+|---------|----------|
+| **PRD** | Write PRD (One Question, OMTM, Hypothesis/Validation) |
+| **HYP** | Formulate hypothesis (Problem → Hypothesis → Validation method) |
+| **PRI** | Prioritization (Impact vs Effort) |
+
+> **Note**: Market analysis → 🗺️ Marco (`/market`). Simon requests market data from Marco.
+
+## Response Format
+
+From now on, respond with the 🎯 icon using Simon's persona.

package/adapters/claude-code/.claude/commands/task.md

@@ -0,0 +1,220 @@
+# /task - Story/Task Status Management
+
+Manage Story status and Task checkboxes integrated with the VitePress kanban board.
+
+## Usage
+
+```bash
+# Change Story status
+/task status E-10-S-01 done        # draft → done
+/task status E-10-S-01 in-progress # draft → in-progress
+
+# Mark Task as complete
+/task done E-10-S-01 1.1           # Complete Task 1.1
+/task done E-10-S-01 1.1 1.2 2.1   # Complete multiple Tasks at once
+
+# Undo Task completion
+/task undo E-10-S-01 1.1           # Revert Task 1.1 to incomplete
+
+# View Story info
+/task E-10-S-01                    # Story detail information
+/task list                         # All Stories in current sprint
+```
+
+## Status Values
+
+| Status | Description |
+|--------|-------------|
+| `draft` | Draft |
+| `ready` | Ready for development |
+| `in-progress` | In development |
+| `review` | Under review |
+| `done` | Complete |
+| `blocked` | Blocked |
+
+---
+
+## Execution Logic
+
+### 1. Change Story Status (`/task status`)
+
+**Find file location**:
+```
+Extract "Current Sprint: **{N}**" from CLAUDE.md → s{N}
+.context/sprints/s{N}/stories/{STORY_ID}.md
+```
+
+**Pattern to modify**:
+```markdown
+| **Status** | `{OLD_STATUS}` |
+→
+| **Status** | `{NEW_STATUS}` |
+```
+
+**Execution example**:
+```bash
+/task status E-10-S-01 done
+```
+
+1. Read `.context/sprints/s52/stories/E-10-S-01.md` file
+2. Find `| **Status** | \`draft\` |`
+3. Change to `| **Status** | \`done\` |`
+4. Save file
+5. Output result
+
+**Output**:
+```
+✅ E-10-S-01 status changed: draft → done
+
+📋 Story: WorkNote Table Design and API
+📁 File: .context/sprints/s52/stories/E-10-S-01.md
+```
+
+---
+
+### 2. Mark Task Complete (`/task done`)
+
+**Pattern to modify**:
+```markdown
+- [ ] **{TASK_ID}**: {description}
+→
+- [x] **{TASK_ID}**: {description}
+```
+
+**Execution example**:
+```bash
+/task done E-10-S-01 1.1 1.2
+```
+
+1. Read `.context/sprints/s52/stories/E-10-S-01.md` file
+2. Find `- [ ] **1.1**:` pattern
+3. Change to `- [x] **1.1**:`
+4. Find `- [ ] **1.2**:` pattern
+5. Change to `- [x] **1.2**:`
+6. Save file
+7. Calculate and output progress
+
+**Output**:
+```
+✅ E-10-S-01 Tasks marked complete
+
+Completed Tasks:
+- [x] 1.1: WorkNote table schema definition
+- [x] 1.2: Migration file generation
+
+📊 Progress: 2/14 tasks (14%)
+```
+
+---
+
+### 3. Undo Task Completion (`/task undo`)
+
+**Pattern to modify**:
+```markdown
+- [x] **{TASK_ID}**: {description}
+→
+- [ ] **{TASK_ID}**: {description}
+```
+
+---
+
+### 4. View Story Info (`/task {STORY_ID}`)
+
+**Execution example**:
+```bash
+/task E-10-S-01
+```
+
+**Output**:
+```
+📋 E-10-S-01: WorkNote Table Design and API
+
+| Item | Value |
+|------|-------|
+| Status | draft |
+| Priority | P0 |
+| Size | M (2 SP) |
+| Owner | TBD (BE) |
+
+## Tasks (0/14 complete)
+
+### Task 1: Table Design
+- [ ] 1.1: WorkNote table schema definition
+- [ ] 1.2: Migration file generation
+- [ ] 1.3: Add indexes
+
+### Task 2: Note Creation API
+- [ ] 2.1: Create POST endpoint
+...
+```
+
+---
+
+### 5. Full Story List (`/task list`)
+
+**Execution example**:
+```bash
+/task list
+/task list in-progress    # Specific status only
+/task list [owner]        # Specific owner only
+```
+
+**Output**:
+```
+📋 Sprint 52 Stories (63 total)
+
+| Status | Count |
+|--------|-------|
+| draft | 45 |
+| in-progress | 5 |
+| done | 13 |
+
+## In Progress (5)
+- E-03-S-02: Dashboard Card Component ([owner], M)
+- E-04-S-01: Metrics Visualization UI ([owner], L)
+...
+```
+
+---
+
+## Auto Sprint Detection
+
+Current sprint number is automatically extracted from `CLAUDE.md`:
+
+```markdown
+## Current Sprint: **52**
+```
+
+→ Uses path `.context/sprints/s52/stories/`
+
+---
+
+## VitePress Auto-Reflection
+
+When Story files are modified, they are automatically reflected on the VitePress kanban board:
+- Dev server running: Instantly reflected via Hot Reload
+- On build: Reflected in next build
+
+---
+
+## Example Workflow
+
+```bash
+# 1. Start work
+/task status E-10-S-01 in-progress
+
+# 2. Check off Tasks as completed
+/task done E-10-S-01 1.1
+/task done E-10-S-01 1.2 1.3
+
+# 3. Complete Story
+/task status E-10-S-01 done
+
+# 4. Check progress
+/task list in-progress
+```
+
+---
+
+*Related features*: VitePress kanban board (`docs/kanban.md`)
+*Data source*: `.context/sprints/s{N}/stories/*.md`