1# Initialize planning files for a new session
2# Usage: .\init-session.ps1 [-Template TYPE] [project-name]
3# Templates: default, analytics
4 
5param(
6    [string]$ProjectName = "project",
7    [string]$Template = "default"
8)
9 
10$DATE = Get-Date -Format "yyyy-MM-dd"
11 
12# Resolve template directory (skill root is one level up from scripts/)
13$ScriptDir = Split-Path -Parent $MyInvocation.MyCommand.Path
14$SkillRoot = Split-Path -Parent $ScriptDir
15$TemplateDir = Join-Path $SkillRoot "templates"
16 
17Write-Host "Initializing planning files for: $ProjectName (template: $Template)"
18 
19# Validate template
20if ($Template -ne "default" -and $Template -ne "analytics") {
21    Write-Host "Unknown template: $Template (available: default, analytics). Using default."
22    $Template = "default"
23}
24 
25# Create task_plan.md if it doesn't exist
26if (-not (Test-Path "task_plan.md")) {
27    $AnalyticsPlan = Join-Path $TemplateDir "analytics_task_plan.md"
28    if ($Template -eq "analytics" -and (Test-Path $AnalyticsPlan)) {
29        Copy-Item $AnalyticsPlan "task_plan.md"
30    } else {
31        @"
32# Task Plan: [Brief Description]
33 
34## Goal
35[One sentence describing the end state]
36 
37## Current Phase
38Phase 1
39 
40## Phases
41 
42### Phase 1: Requirements & Discovery
43- [ ] Understand user intent
44- [ ] Identify constraints
45- [ ] Document in findings.md
46- **Status:** in_progress
47 
48### Phase 2: Planning & Structure
49- [ ] Define approach
50- [ ] Create project structure
51- **Status:** pending
52 
53### Phase 3: Implementation
54- [ ] Execute the plan
55- [ ] Write to files before executing
56- **Status:** pending
57 
58### Phase 4: Testing & Verification
59- [ ] Verify requirements met
60- [ ] Document test results
61- **Status:** pending
62 
63### Phase 5: Delivery
64- [ ] Review outputs
65- [ ] Deliver to user
66- **Status:** pending
67 
68## Decisions Made
69| Decision | Rationale |
70|----------|-----------|
71 
72## Errors Encountered
73| Error | Resolution |
74|-------|------------|
75"@ | Out-File -FilePath "task_plan.md" -Encoding UTF8
76    }
77    Write-Host "Created task_plan.md"
78} else {
79    Write-Host "task_plan.md already exists, skipping"
80}
81 
82# Create findings.md if it doesn't exist
83if (-not (Test-Path "findings.md")) {
84    $AnalyticsFindings = Join-Path $TemplateDir "analytics_findings.md"
85    if ($Template -eq "analytics" -and (Test-Path $AnalyticsFindings)) {
86        Copy-Item $AnalyticsFindings "findings.md"
87    } else {
88        @"
89# Findings & Decisions
90 
91## Requirements
92-
93 
94## Research Findings
95-
96 
97## Technical Decisions
98| Decision | Rationale |
99|----------|-----------|
100 
101## Issues Encountered
102| Issue | Resolution |
103|-------|------------|
104 
105## Resources
106-
107"@ | Out-File -FilePath "findings.md" -Encoding UTF8
108    }
109    Write-Host "Created findings.md"
110} else {
111    Write-Host "findings.md already exists, skipping"
112}
113 
114# Create progress.md if it doesn't exist
115if (-not (Test-Path "progress.md")) {
116    if ($Template -eq "analytics") {
117        @"
118# Progress Log
119 
120## Session: $DATE
121 
122### Current Status
123- **Phase:** 1 - Data Discovery
124- **Started:** $DATE
125 
126### Actions Taken
127-
128 
129### Query Log
130| Query | Result Summary | Interpretation |
131|-------|---------------|----------------|
132 
133### Errors
134| Error | Resolution |
135|-------|------------|
136"@ | Out-File -FilePath "progress.md" -Encoding UTF8
137    } else {
138        @"
139# Progress Log
140 
141## Session: $DATE
142 
143### Current Status
144- **Phase:** 1 - Requirements & Discovery
145- **Started:** $DATE
146 
147### Actions Taken
148-
149 
150### Test Results
151| Test | Expected | Actual | Status |
152|------|----------|--------|--------|
153 
154### Errors
155| Error | Resolution |
156|-------|------------|
157"@ | Out-File -FilePath "progress.md" -Encoding UTF8
158    }
159    Write-Host "Created progress.md"
160} else {
161    Write-Host "progress.md already exists, skipping"
162}
163 
164Write-Host ""
165Write-Host "Planning files initialized!"
166Write-Host "Files: task_plan.md, findings.md, progress.md"
167