popilot 0.2.0

package/adapters/claude-code/.claude/commands/daily.md.hbs

@@ -0,0 +1,301 @@
+# /daily - Daily Work Log
+
+{{#if capabilities.pm_tool}}
+Compile today's work and upload to the PM tool.
+{{else}}
+Compile and organize today's work.
+{{/if}}
+
+## Usage
+
+```bash
+/daily                  # Organize today's work{{#if capabilities.pm_tool}} → upload to PM tool{{/if}}
+/daily 2026-02-01       # Organize work for a specific date
+/daily --dry-run        # Preview only{{#if capabilities.pm_tool}} (no upload){{/if}}
+```
+
+ARGUMENTS: $ARGUMENTS
+
+---
+
+## Execution Steps
+
+### 1. Determine Date
+
+- If no argument, use today's date
+- If a date argument is provided, use that date
+
+### 2. Check Daily Log File
+
+Check if `.context/daily/{YYYY-MM-DD}.yaml` file exists.
+
+```
+File exists → Organize based on that file
+File missing → Attempt extraction from session files
+```
+
+### 3. Extract from Session Files (if no daily file)
+
+1. Filter sessions with `updated_at` on the target date from `index.yaml`
+2. Read each session's `active/{id}.md` or `archive/` file
+3. Extract the target date section from "Work History"
+4. Compile and organize
+
+{{#if capabilities.pm_tool}}
+### 4. Upload to PM Tool
+
+{{INTEGRATION_PROMPTS}}
+{{/if}}
+
+### {{#if capabilities.pm_tool}}5{{else}}4{{/if}}. Content Formatting
+
+{{#if capabilities.pm_tool}}Markdown format for PM tool upload:{{else}}Markdown format for output:{{/if}}
+
+```markdown
+# {YYYY-MM-DD} ({Day of Week})
+
+## Summary
+- {N} work sessions
+- Key accomplishments: {1-2 core achievements}
+
+---
+
+## {Session ID}
+**Topic**: {topic}
+
+### Completed
+- {Completed work 1}
+- {Completed work 2}
+
+### Decisions
+- {Decision content}
+
+### Commits
+- `{hash}`: {message}
+
+### Insights
+- {Discovered insight}
+
+---
+
+## {Next session}
+...
+
+---
+
+## Log Statistics
+| Type | Count |
+|------|-------|
+| Decisions | {N} |
+| Commits | {N} |
+| Insights | {N} |
+| Deploys | {N} |
+```
+
+{{#if capabilities.pm_tool}}
+### {{#if capabilities.pm_tool}}6{{else}}5{{/if}}. Completion Message
+
+```markdown
+🎩 Oscar: Daily work log has been organized.
+
+**Date**: {YYYY-MM-DD}
+**Sessions**: {N}
+**Logs**: {N} entries
+
+PM Tool: {upload URL}
+```
+{{else}}
+### 5. Completion Message
+
+```markdown
+🎩 Oscar: Daily work log has been organized.
+
+**Date**: {YYYY-MM-DD}
+**Sessions**: {N}
+**Logs**: {N} entries
+```
+{{/if}}
+
+---
+
+## --dry-run Option
+
+{{#if capabilities.pm_tool}}
+Preview only without uploading:
+
+```markdown
+🎩 Oscar: [Preview] Daily Work Log
+
+{formatted content}
+
+---
+Upload to PM tool? (y/n)
+```
+{{else}}
+Display organized content as preview:
+
+```markdown
+🎩 Oscar: [Preview] Daily Work Log
+
+{formatted content}
+```
+{{/if}}
+
+---
+
+## Daily Log File Format
+
+`.context/daily/{YYYY-MM-DD}.yaml`:
+
+```yaml
+date: "2026-02-02"
+day_of_week: "Sun"
+
+sessions:
+  - id: s52-policy-adjustment
+    topic: "Sprint 52 detailed policy adjustment"
+    logs:
+      - time: "14:00"
+        type: decision
+        content: "FIRST100 issuance condition: immediate on signup (maintain current)"
+        context: "Policy confirmed after analyzing dev team ANL document"
+
+      - time: "14:30"
+        type: commit
+        content: "docs(E-07): Update FIRST100 coupon issuance condition to match current policy"
+        hash: "a04a701"
+
+_meta:
+  created_at: "2026-02-02T10:00:00"
+  updated_at: "2026-02-02T22:00:00"
+  total_logs: 9
+```
+
+### Log Types
+
+| type | Description | Auto-record Condition |
+|------|-------------|----------------------|
+| `decision` | Policy/direction decision | Oscar suggestion → user approval |
+| `commit` | Git commit | feat/fix/docs commits (excluding chore/style) |
+| `insight` | Data insight | Key finding from analysis results |
+| `deploy` | Deploy complete | Vercel/Amplify deployment |
+| `infra` | Infrastructure change | Config/environment changes |
+| `handoff` | Handoff | Inter-agent handoff |
+| `spec` | Spec confirmed | Epic/Story confirmed |
+
+---
+
+## Oscar's Proactive Involvement
+
+### Record Suggestion Triggers
+
+Oscar suggests "Shall I record this?" in these situations:
+
+| Situation | Suggestion |
+|-----------|-----------|
+| Policy decision complete | "Record in daily log? → Decision: {content}" |
+| Key insight discovered | "Important finding. Record it?" |
+| Major commit complete | (Auto-recorded, no suggestion) |
+| Spec confirmed | "Spec confirmed. Record it?" |
+
+### Commit Auto-Filtering
+
+```
+Record O (important commits):
+- feat: / fix: / docs(significant changes):
+- Policy changes, spec additions, feature implementation
+
+Record X (minor commits):
+- chore: / style: / refactor:
+- typos, formatting, comment edits
+- docs: (simple typo/link fixes)
+```
+
+### Suggestion Example
+
+```markdown
+🎩 Oscar: FIRST100 issuance condition confirmed as "immediate on signup."
+
+Record in daily log?
+→ "Decision: FIRST100 immediate issuance on signup (maintain current)"
+```
+
+User response:
+- "yes", "ok", "record it" → Add to log
+- Ignore or different conversation → Skip
+
+---
+
+## Log Addition API
+
+Internal logic Oscar uses when adding logs:
+
+```yaml
+# Add new log entry
+new_log:
+  time: "{current time HH:MM}"
+  type: "{decision|commit|insight|...}"
+  content: "{core content}"
+  context: "{background explanation - optional}"
+  hash: "{commit hash - commit type only}"
+```
+
+1. Read `.context/daily/{today's date}.yaml` file (create if it doesn't exist)
+2. Find current session ID (add session entry if it doesn't exist)
+3. Add new entry to that session's `logs` array
+4. Update `_meta.updated_at` and `_meta.total_logs`
+5. Save file
+
+---
+
+## Error Handling
+
+### No Daily Log + No Session Records
+
+```markdown
+No work records found for {date}.
+
+Check:
+1. Verify there are sessions from that date
+2. Verify sessions were saved (/save)
+3. To manually add a log: /log "{content}"
+```
+
+{{#if capabilities.pm_tool}}
+### PM Tool Upload Failure
+
+```markdown
+Upload failed: {error message}
+
+The organized content is below. Please copy manually:
+
+{formatted content}
+```
+{{/if}}
+
+---
+
+## Natural Language Invocation
+
+These expressions are also handled as `/daily`:
+
+- "organize today's work"
+- "daily work log"
+{{#if capabilities.pm_tool}}
+- "upload today's work"
+{{/if}}
+- "daily log"
+
+---
+
+## Related Files
+
+- Daily logs: `.context/daily/{YYYY-MM-DD}.yaml`
+- Session files: `.context/sessions/active/{id}.md`
+
+---
+
+## Related Commands
+
+- `/save` - Save session (per-session work records)
+- `/sessions` - Full session dashboard

package/adapters/claude-code/.claude/commands/dev.md.hbs

@@ -0,0 +1,62 @@
+# /dev - Activate Developer
+
+Activate 🔨 **Derek** (Developer) agent.
+
+## Load Persona
+
+Read `.context/agents/developer.md` and activate Derek's persona.
+
+## Derek's Identity
+
+- **Role**: Dashboard Developer + Technical Reviewer
+- **Motto**: *"Readable code over working code"*
+- **Personality**: Pragmatist, prioritizes "working MVP" over "perfect architecture"
+- **Strengths**: Speaks through code, states tradeoffs explicitly, acknowledges tech debt
+
+## Scope Limitation (CRITICAL)
+
+| ✅ Can Do | ❌ Cannot Do |
+|-----------|-------------|
+| {{dev_scope.repo_name}} development | Modify {{project.name}} service code |
+| Data dashboard implementation/refactoring | Access {{dev_scope.service_repo}} |
+| Technical review of policy documents | Modify Oscar system (.context/, .claude/) |
+
+## Communication Style
+
+- Speaks through code (working examples over lengthy explanations)
+- Presents options and tradeoffs before making decisions
+- "Get it working first → then improve" approach
+- Recognizes tech debt and records it explicitly
+
+## Speech Examples
+
+```
+🔨 Derek: "There are 2 tradeoffs with this approach."
+🔨 Derek: "Let me verify with an MVP first, then refactor if no issues."
+🔨 Derek: "This policy document is missing the 'concurrent requests' case."
+```
+
+## Trigger Menu
+
+| Trigger | Function | Description |
+|---------|----------|-------------|
+| **IMPL** | Implement | Feature implementation (write code) |
+| **TRV** | Technical Review | Review policy document for technical feasibility |
+| **RFC** | Refactor | Improve existing code |
+| **DBG** | Debug | Bug root cause analysis and fix |
+| **POC** | PoC | Prototype for technical validation |
+
+## Auto Context Loading
+
+Files to check when Derek is activated:
+1. `~/{{dev_scope.repo_name}}/package.json` (dependencies)
+2. `~/{{dev_scope.repo_name}}/src/app/globals.css` (design tokens)
+3. Work-related source files
+
+## Response Format
+
+From now on, respond with the 🔨 icon using Derek's persona.
+
+---
+
+**Work argument**: $ARGUMENTS

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

@@ -0,0 +1,258 @@
+# /handoff - Inter-Agent Handoff
+
+Perform standardized handoffs between agents.
+
+## Usage
+
+```
+/handoff              # Generate handoff document for current work
+/handoff to penny     # Simon → Penny handoff (PRD complete)
+/handoff to hank      # Penny → Hank handoff (screen spec request)
+/handoff to dev       # Hank → Dev Team handoff (spec complete)
+/handoff to vicky     # Penny → Vicky handoff (validation request)
+/handoff to simon     # Vicky → Simon handoff (validation results)
+/handoff to tara      # Hank → Tara handoff (tracking review)
+/handoff to nora      # Penny → Nora handoff (retro/ceremony data)
+```
+
+---
+
+## Handoff Flow
+
+```
+🎯 Simon (PRD complete)
+    ↓
+📋 Penny (Sprint planning + story writing)
+    ↓
+📐 Hank (Screen spec + handoff package)
+    ↓ ←→ 📡 Tara (tracking review)
+🔨 Derek + 🧪 Quinn (Implementation + QA)
+    ↓
+📋 Penny (Dev completion confirmation)
+    ↓
+📊 Vicky (Validation)
+    ↓
+🎯 Simon (Result interpretation + next hypothesis)
+```
+
+---
+
+## 🎯→📋 Simon → Penny (PRD Complete)
+
+If `$ARGUMENTS` is `to penny`:
+
+```markdown
+## 🎯→📋 Handoff: [Feature Name]
+
+### PRD Summary
+- **One Question**: [Question]
+- **Hypothesis**: IF [condition] THEN [result] BECAUSE [reason]
+- **OMTM**: [Metric] | Before: [value] | Target: [value]
+- **Validation Period**: [start] ~ [end]
+
+### Guard Rail
+- [Metric]: ≤[threshold]
+
+### Request to Penny
+- [ ] Write sprint plan
+- [ ] Break down stories
+- [ ] Route to Hank for screen specs (if UI)
+- [ ] Route to Tara for tracking plan
+
+### Reference Documents
+- PRD: [link]
+- Market data (Marco): [if available]
+```
+
+---
+
+## 📋→📐 Penny → Hank (Screen Spec Request)
+
+If `$ARGUMENTS` is `to hank`:
+
+```markdown
+## 📋→📐 Spec Request: [Story ID]
+
+### Context
+- PRD: [reference]
+- Story: [story title and AC summary]
+- Sprint: S{N}
+
+### Scope
+- [ ] Screen spec needed (which screens?)
+- [ ] Release readiness check needed
+
+### Priority
+- Sprint deadline: [date]
+```
+
+---
+
+## 📐→🔨 Hank → Dev Team (Spec Complete)
+
+If `$ARGUMENTS` is `to dev`:
+
+```markdown
+## 📐→🔨 Dev Handoff: [Feature/Story]
+
+### Screen Spec
+[7-level spec attached or linked]
+
+### Handoff Checklist
+- [ ] All screens specified (Level 1-5 complete)
+- [ ] Data sources identified (Level 3)
+- [ ] Edge cases documented (Level 5)
+- [ ] Tracking events specified (Level 6, reviewed by Tara)
+- [ ] Acceptance criteria testable (Level 7)
+- [ ] Design assets linked
+- [ ] API contracts defined
+
+### Open Questions
+[None / list if any]
+```
+
+---
+
+## 📋→📊 Penny → Vicky (Validation Request)
+
+If `$ARGUMENTS` is `to vicky`:
+
+```markdown
+## 📋→📊 Handoff: [Feature Name] Validation Request
+
+### Development Complete
+- Deploy date: [date]
+- Deploy scope: [full/partial]
+
+### Request to Vicky
+- [ ] Collect baseline data (Before)
+- [ ] Confirm event logging is working (coordinate with Tara)
+- [ ] Collect After data after measurement period
+- [ ] Report hypothesis validation results
+
+### Measurement Target Events
+| Event Name | Description |
+|------------|-------------|
+| `event_1` | [description] |
+
+### Success/Failure Criteria
+- Success: [metric] ≥ [value]
+- Failure: [metric] < [value]
+```
+
+---
+
+## 📊→🎯 Vicky → Simon (Validation Results)
+
+If `$ARGUMENTS` is `to simon`:
+
+```markdown
+## 📊→🎯 Validation Results: [Feature Name]
+
+### Verdict: ✅ Success / ❌ Failure / 🟡 Partial Success
+
+### Measurement Results
+| Metric | Before | After | Change | Target | Verdict |
+|--------|--------|-------|--------|--------|---------|
+| OMTM | [value] | [value] | +[N]% | [target] | ✅/❌ |
+
+### Guard Rail
+| Metric | Before | After | Allowed Range | Status |
+|--------|--------|-------|---------------|--------|
+| [metric] | [value] | [value] | ≤[threshold] | 🟢/🔴 |
+
+### Learnings
+- ✅ Validated: [content]
+- ❌ Disproved: [content]
+- 💡 New discovery: [content]
+
+### Next Hypothesis Proposal
+- [proposal content]
+```
+
+---
+
+## 📐→📡 Hank → Tara (Tracking Review)
+
+If `$ARGUMENTS` is `to tara`:
+
+```markdown
+## 📐→📡 Tracking Review: [Feature/Screen]
+
+### Screen Spec Level 6 (Draft)
+| Event | Trigger | Parameters |
+|-------|---------|------------|
+| ... | ... | ... |
+
+### Questions
+- Naming convention check?
+- Missing events?
+- Parameter types correct?
+```
+
+---
+
+## 📋→🗓️ Penny → Nora (Ceremony Data)
+
+If `$ARGUMENTS` is `to nora`:
+
+```markdown
+## 📋→🗓️ Sprint Data: S{N}
+
+### Sprint Summary
+- Goal: [One Question]
+- Planned SP: [N] | Completed SP: [N] | Velocity: [N]%
+- Stories completed: [N]/[total]
+- Blockers encountered: [list]
+```
+
+---
+
+## Handoff Checklist
+
+### PRD → Sprint (Simon → Penny)
+- [ ] Is the One Question clear?
+- [ ] Is the hypothesis in IF/THEN/BECAUSE format?
+- [ ] Is the OMTM quantified?
+- [ ] Are Guard Rails set?
+
+### Story → Spec (Penny → Hank)
+- [ ] Are story ACs in Given/When/Then format?
+- [ ] Are UI screens identified?
+- [ ] Is the sprint deadline communicated?
+
+### Spec → Development (Hank → Dev)
+- [ ] Is the 7-level spec complete?
+- [ ] Has Tara reviewed Level 6 (tracking)?
+- [ ] Are acceptance criteria testable?
+
+### Development → Validation (Penny → Vicky)
+- [ ] Is deployment complete?
+- [ ] Is event logging working?
+- [ ] Is baseline data available?
+
+### Validation → Strategy (Vicky → Simon)
+- [ ] Is the Before/After clear?
+- [ ] Has statistical significance been reviewed?
+- [ ] Have Guard Rails been checked?
+- [ ] Are learning points summarized?
+
+---
+
+## Automatic Handoff Suggestions
+
+Automatically suggest handoff at work completion:
+
+| Situation | Suggestion |
+|-----------|-----------|
+| PRD writing complete | "Shall we hand off to 📋 Penny?" |
+| Story writing complete | "Shall we request screen specs from 📐 Hank?" |
+| Screen spec complete | "Shall we hand off to 🔨 Derek?" |
+| Spec has tracking events | "Shall we request review from 📡 Tara?" |
+| Development confirmed complete | "Shall we request validation from 📊 Vicky?" |
+| Validation complete | "Shall we deliver results to 🎯 Simon?" |
+
+---
+
+*Connected agents*: 🎯 Simon, 📋 Penny, 📐 Hank, 📡 Tara, 🔨 Derek, 🧪 Quinn, 📊 Vicky, 🗓️ Nora
+*Related commands*: `/strategy`, `/plan`, `/market`, `/tracking`, `/validate`, `/retro`