create-dss-project 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (83) hide show
  1. package/bin/create-dss-project.js +4 -0
  2. package/lib/index.js +80 -0
  3. package/lib/project-types.js +74 -0
  4. package/lib/prompts.js +42 -0
  5. package/lib/scaffold.js +169 -0
  6. package/package.json +30 -0
  7. package/template/.github/workflows/dashboard-build.yml +27 -0
  8. package/template/.github/workflows/template-lint.yml +71 -0
  9. package/template/CHANGELOG.md +43 -0
  10. package/template/CLAUDE.md +145 -0
  11. package/template/LICENSE +21 -0
  12. package/template/README.md +201 -0
  13. package/template/STATUS.md +34 -0
  14. package/template/context/competitor-snapshot.md +27 -0
  15. package/template/context/market-snapshot.md +32 -0
  16. package/template/context/pipeline-state.md +36 -0
  17. package/template/context/project-state.md +45 -0
  18. package/template/dashboard/CLAUDE.md +36 -0
  19. package/template/dashboard/DEPLOY.md +60 -0
  20. package/template/dashboard/build-data.js +395 -0
  21. package/template/dashboard/competitors.html +143 -0
  22. package/template/dashboard/css/styles.css +143 -0
  23. package/template/dashboard/data/.gitkeep +0 -0
  24. package/template/dashboard/decisions.html +132 -0
  25. package/template/dashboard/index.html +152 -0
  26. package/template/dashboard/js/app.js +59 -0
  27. package/template/dashboard/js/overview.js +50 -0
  28. package/template/dashboard/js/sidebar.js +62 -0
  29. package/template/dashboard/js/tailwind-config.js +52 -0
  30. package/template/dashboard/package-lock.json +351 -0
  31. package/template/dashboard/package.json +17 -0
  32. package/template/dashboard/pipeline.html +149 -0
  33. package/template/dashboard/research.html +215 -0
  34. package/template/dashboard/robots.txt +2 -0
  35. package/template/dashboard/scoring.html +187 -0
  36. package/template/dashboard/timeline.html +165 -0
  37. package/template/dashboard/vercel.json +5 -0
  38. package/template/dashboard/watch.js +57 -0
  39. package/template/data/.gitkeep +0 -0
  40. package/template/discovery/calls/.gitkeep +0 -0
  41. package/template/discovery/outreach/.gitkeep +0 -0
  42. package/template/discovery/prep/.gitkeep +0 -0
  43. package/template/docs/decks/.gitkeep +0 -0
  44. package/template/docs/executive-summary.md +104 -0
  45. package/template/docs/getting-started.md +274 -0
  46. package/template/docs/memos/evidence-grading.md +27 -0
  47. package/template/docs/memos/housekeeping-reference.md +101 -0
  48. package/template/docs/memos/reference-context.md +30 -0
  49. package/template/docs/output/project-activity.md +8 -0
  50. package/template/docs/output/status-blurb.md +4 -0
  51. package/template/docs/output/work-log.md +8 -0
  52. package/template/docs/skill-authoring-guide.md +212 -0
  53. package/template/memory/MEMORY.md +84 -0
  54. package/template/memory/decisions.md +13 -0
  55. package/template/memory/discovery.md +48 -0
  56. package/template/memory/research.md +33 -0
  57. package/template/memory/scoring.md +34 -0
  58. package/template/project.config.example.json +31 -0
  59. package/template/research/competitors/.gitkeep +0 -0
  60. package/template/research/market/.gitkeep +0 -0
  61. package/template/research/technical/.gitkeep +0 -0
  62. package/template/scripts/.gitkeep +0 -0
  63. package/template/scripts/build-cli-template.sh +32 -0
  64. package/template/scripts/health-check.sh +152 -0
  65. package/template/scripts/reset-to-template.sh +115 -0
  66. package/template/scripts/validate-placeholders.sh +47 -0
  67. package/template/skills/compare-options/SKILL.md +97 -0
  68. package/template/skills/critical-reasoning/SKILL.md +107 -0
  69. package/template/skills/decision/SKILL.md +75 -0
  70. package/template/skills/enrich-entity/SKILL.md +107 -0
  71. package/template/skills/health-check/SKILL.md +144 -0
  72. package/template/skills/onboard/SKILL.md +434 -0
  73. package/template/skills/outreach-sequence/SKILL.md +79 -0
  74. package/template/skills/pipeline-update/SKILL.md +90 -0
  75. package/template/skills/process-call/SKILL.md +96 -0
  76. package/template/skills/rebuild-snapshots/SKILL.md +88 -0
  77. package/template/skills/session-end/SKILL.md +120 -0
  78. package/template/skills/session-start/SKILL.md +93 -0
  79. package/template/skills/synthesise/SKILL.md +108 -0
  80. package/template/skills/weekly-report/SKILL.md +79 -0
  81. package/template/templates/call-notes.md +67 -0
  82. package/template/templates/call-prep.md +65 -0
  83. package/template/templates/entity-teardown.md +58 -0
@@ -0,0 +1,145 @@
1
+ # CLAUDE.md
2
+
3
+ ## Current Date
4
+
5
+ Always use `date` via Bash to get today's date at the start of a session.
6
+
7
+ ## What We're Building
8
+
9
+ **{{PROJECT_NAME}}** — {{ONE_LINE_DESCRIPTION}}. Goal: {{GOAL}}. Team: {{TEAM}}.
10
+
11
+ ## Scope
12
+
13
+ {{SCOPE_DEFINITION}}. Out of scope: {{OUT_OF_SCOPE}}.
14
+
15
+ ## Core Bet
16
+
17
+ {{STRATEGIC_HYPOTHESIS}}
18
+
19
+ ## Target Customer
20
+
21
+ {{ICP_DESCRIPTION}}
22
+
23
+ ---
24
+
25
+ ## Project Configuration
26
+
27
+ Project settings are stored in `project.config.json` (generated by `/onboard`). Skills read this file for project name, entity types, module flags, and scoring dimensions. See `project.config.example.json` for the schema.
28
+
29
+ ---
30
+
31
+ ## Context Loading
32
+
33
+ Load the snapshot for your task type. **Do not read raw source files unless the snapshot is insufficient for your task.**
34
+
35
+ | Task | Load first |
36
+ |------|-----------|
37
+ | Discovery call prep, hypothesis work, strategic review | `context/project-state.md` |
38
+ | Pipeline updates, outreach, call scheduling | `context/pipeline-state.md` |
39
+ | Competitor or market research | `context/competitor-snapshot.md` + `context/market-snapshot.md` |
40
+ | End-of-session (`/session-end`) | `context/project-state.md` (verify what changed this session) |
41
+
42
+ ### Three Loading Modes
43
+
44
+ | Mode | When | Rule |
45
+ |------|------|------|
46
+ | **Fast** | Pipeline updates, housekeeping, scheduling, call prep | Snapshot only |
47
+ | **Standard** | Research, competitor analysis, entity enrichment | Snapshot + targeted raw files as needed |
48
+ | **Deep** | Hypothesis review, critical reasoning, kill condition updates, strategic decisions | Load snapshot for orientation — then read ALL raw evidence before forming any view |
49
+
50
+ **Deep mode rule**: Snapshots tell you what was concluded; raw files contain disconfirming signals, hedged language, and contradictions that drive good reasoning. For hypothesis-class work, reading only snapshots is not acceptable.
51
+
52
+ Raw evidence sources for Deep mode:
53
+ - All files in `discovery/calls/` — every call note
54
+ - `memory/decisions.md` — full decision log with rationale
55
+ - `memory/research.md` — capability map and market findings
56
+
57
+ ---
58
+
59
+ ## Multi-Agent Coordination
60
+
61
+ ### Before Starting
62
+ 1. Run `/session-start` — it checks conflicts, loads context, and shows priorities.
63
+ 2. Add yourself to "In Progress" with workstream, item, date.
64
+ 3. Use templates from `templates/`.
65
+
66
+ ### While Working
67
+ - One file per unit of work.
68
+ - Research → `research/`. Discovery → `discovery/`. Docs → `docs/`.
69
+ - Never overwrite another agent's in-progress file without reading it first.
70
+
71
+ ### Pipeline Work
72
+ Dashboard source of truth: `{{PIPELINE_SOURCE_OF_TRUTH}}` — add {{ENTITY_TYPE_PLURAL}} here first, never only to JSON.
73
+
74
+ ### After Completing Work
75
+ 1. Move STATUS.md row to "Completed Recently".
76
+ 2. Update the relevant `context/` snapshot — keep it current for the next session.
77
+ 3. If work changes hypothesis or kill conditions → run `/critical-reasoning` before updating `docs/executive-summary.md`.
78
+
79
+ ### Executive Summary Rule
80
+ `docs/executive-summary.md` is the single source of truth. Update after: every discovery call, kill condition changes, major research, strategic decisions.
81
+
82
+ ### Agent Briefing Format
83
+ Task → Constraints → 3–5 key facts (with file paths, not content) → output spec → model weight. No file content dumps.
84
+
85
+ ---
86
+
87
+ ## Model Routing
88
+
89
+ Default: Opus. Switch to Sonnet for mechanical/template work (`/model sonnet`).
90
+
91
+ Opus required: hypothesis review, discovery call processing, critical reasoning, strategic decisions.
92
+ Sonnet fine: competitor research, call prep, housekeeping, dashboard/data work.
93
+
94
+ ---
95
+
96
+ ## End-of-Session Housekeeping (MANDATORY)
97
+
98
+ Run `/session-end`. This executes the full 10-step housekeeping checklist automatically (file audit, memory cascade, hypothesis review, status sync, dashboard rebuild, commit). Reference: `docs/memos/housekeeping-reference.md`.
99
+
100
+ After any session that changes discovery, pipeline, or decisions — `/session-end` will regenerate the affected `context/` snapshot via `/rebuild-snapshots`.
101
+
102
+ Evidence grading rules: `docs/memos/evidence-grading.md`
103
+
104
+ ---
105
+
106
+ ## Project-Level Skills
107
+
108
+ <!-- These skills live in this project's skills/ directory -->
109
+
110
+ | Skill | Phase | Description |
111
+ |-------|-------|-------------|
112
+ | `/onboard` | Setup | One-time project configuration wizard |
113
+ | `/session-start` | Session | Load context, check conflicts, show priorities |
114
+ | `/session-end` | Session | 10-step end-of-session housekeeping |
115
+ | `/health-check` | Quality | Project integrity audit and health score |
116
+ | `/rebuild-snapshots` | Session | Regenerate all context snapshots from raw files |
117
+ | `/pipeline-update` | Pipeline | Track entity status transitions |
118
+ | `/outreach-sequence` | Pipeline | Design multi-touch outreach cadences |
119
+ | `/process-call` | Discovery | Post-discovery-call structured processing |
120
+ | `/enrich-entity` | Research | Deep research and dashboard enrichment for an entity |
121
+ | `/synthesise` | Research | Cross-file research synthesis into structured memos |
122
+ | `/critical-reasoning` | Analysis | Pressure-test ideas with 4 lenses: truth, consequences, risks, feasibility |
123
+ | `/decision` | Analysis | Record strategic decisions with full rationale |
124
+ | `/compare-options` | Analysis | Score and compare 2–5 strategic options |
125
+ | `/weekly-report` | Reporting | Generate stakeholder-ready weekly summaries |
126
+
127
+ ---
128
+
129
+ ## Relevant User-Level Skills
130
+
131
+ <!-- These skills live at ~/.claude/skills/ and are available across all projects.
132
+ Add project-specific context sections to them if needed. -->
133
+
134
+ - `/bottom-up-tam`, `/micro-segmentation` — market sizing
135
+ - `/critical-reasoning` — hypothesis stress-testing (project-level version is domain-agnostic)
136
+ - `/strategic-framework-synthesiser` — structured analysis (Porter's, PESTLE, BCG, etc.)
137
+ - `/gtm-playbook` — go-to-market planning
138
+ - `/outside-in-benchmarking` — competitive analysis
139
+ - `/pricing-packaging` — monetisation design
140
+ - `/unit-economics-modeler` — CAC, LTV, payback period
141
+ - `/burning-platform` — change management narratives
142
+ - `/macro-trend-synthesis` — PESTLE+ trend analysis
143
+ - `/partnership-ecosystem-strategy` — partner program design
144
+ - `/product-roadmap-prioritisation` — backlog prioritisation
145
+ - `/profit-pool-mapping` — value chain analysis
@@ -0,0 +1,21 @@
1
+ MIT Licence
2
+
3
+ Copyright (c) 2026 DS Strategy Stack Contributors
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicence, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
@@ -0,0 +1,201 @@
1
+ # DS Strategy Stack (Claude Code)
2
+
3
+ > An open-source, AI-powered strategy and project management stack for Claude Code. Clone it, run `/onboard`, and start doing real work — market entry, competitor research, internal implementations, due diligence, or any corporate project that needs structured thinking.
4
+
5
+ [![MIT Licence](https://img.shields.io/badge/licence-MIT-blue.svg)](LICENSE)
6
+
7
+ ---
8
+
9
+ ## What Is This?
10
+
11
+ A complete strategy project framework that runs inside [Claude Code](https://claude.ai/code). It gives you:
12
+
13
+ - **14 skills** that automate strategy workflows (research, discovery, analysis, reporting)
14
+ - **A live dashboard** (Vercel-deployable) showing kill conditions, pipeline, competitors, decisions, and more
15
+ - **A memory layer** that persists strategic context across sessions
16
+ - **Multi-agent coordination** so multiple Claude instances can work on the same project
17
+ - **Evidence grading** on every claim — `[CONFIRMED]`, `[SECONDARY]`, `[INFERENCE]`, `[ASSUMPTION]`
18
+ - **Kill condition tracking** — falsifiable thresholds that tell you when to stop or pivot
19
+
20
+ No boilerplate. No blank-page problem. Clone, configure, and go.
21
+
22
+ ![Dashboard Screenshot](dashboard/screenshot.png)
23
+
24
+ ---
25
+
26
+ ## Quick Start
27
+
28
+ ### Option A: npx (recommended)
29
+
30
+ ```bash
31
+ npx create-dss-project my-project
32
+ cd my-project
33
+ claude
34
+ /onboard
35
+ ```
36
+
37
+ The scaffolder asks 3 questions (project name, type, structure level) and sets up a ready-to-go project with the right modules pre-configured.
38
+
39
+ ### Option B: Git clone
40
+
41
+ ```bash
42
+ git clone https://github.com/DiffTheEnder/DSS-Claude-Stack.git my-project
43
+ cd my-project
44
+ claude
45
+ /onboard
46
+ ```
47
+
48
+ Both paths end at `/onboard`, which walks you through the full configuration — **Quick Start** (7 questions) or **Full Setup** (16 questions). It asks about your goals, experience level, and which features you want, then generates your `project.config.json`, populates placeholders, and activates the right modules.
49
+
50
+ > **New to coding?** See the [Getting Started Guide](docs/getting-started.md) for step-by-step instructions covering installation, setup, and Vercel deployment — no programming knowledge needed.
51
+
52
+ ---
53
+
54
+ ## Features
55
+
56
+ ### Skills Library (14 skills)
57
+
58
+ | Skill | Phase | Description |
59
+ |-------|-------|-------------|
60
+ | `/onboard` | Setup | One-time project configuration wizard |
61
+ | `/session-start` | Session | Load context, check conflicts, show priorities |
62
+ | `/session-end` | Session | 10-step end-of-session housekeeping |
63
+ | `/health-check` | Quality | Project integrity audit and health score |
64
+ | `/rebuild-snapshots` | Session | Regenerate all context snapshots from raw files |
65
+ | `/pipeline-update` | Pipeline | Track entity status transitions |
66
+ | `/outreach-sequence` | Pipeline | Design multi-touch outreach cadences |
67
+ | `/process-call` | Discovery | Post-discovery-call structured processing |
68
+ | `/enrich-entity` | Research | Deep research and dashboard enrichment for an entity |
69
+ | `/synthesise` | Research | Cross-file research synthesis into structured memos |
70
+ | `/critical-reasoning` | Analysis | Pressure-test ideas with 4 lenses: truth, consequences, risks, feasibility |
71
+ | `/decision` | Analysis | Record strategic decisions with full rationale |
72
+ | `/compare-options` | Analysis | Score and compare 2–5 strategic options |
73
+ | `/weekly-report` | Reporting | Generate stakeholder-ready weekly summaries |
74
+
75
+ ### Live Dashboard
76
+
77
+ - **7 pages**: Overview, Pipeline, Competitors, Decisions, Scoring, Timeline, Research Hub
78
+ - Warm cream/teal editorial design with dark mode
79
+ - Auto-rebuilds from markdown/CSV source files
80
+ - Deploys to Vercel on push
81
+
82
+ > **Note:** The dashboard is intentionally a simple starting point — a 101-level view of your project. Every project is different, so we'd encourage you to add custom pages, new data flows, and visualisations that fit your specific context. The [Skill Authoring Guide](docs/skill-authoring-guide.md) and [Dashboard Architecture](dashboard/CLAUDE.md) docs explain how to extend both the skills and the dashboard. Ask Claude to help — "add a new dashboard page that shows X" works great.
83
+
84
+ ### Memory & Context System
85
+
86
+ - **5 persistent memory files** tracking research, discovery, decisions, and scoring
87
+ - **4 pre-computed context snapshots** for fast session loading
88
+ - **Three loading modes**: Fast, Standard, Deep — so you only load what you need
89
+
90
+ ---
91
+
92
+ ## Architecture
93
+
94
+ ```
95
+ my-project/
96
+ ├── CLAUDE.md # Agent instructions & context loading rules
97
+ ├── STATUS.md # Multi-agent coordination board
98
+ ├── project.config.json # Project configuration (generated by /onboard)
99
+ ├── memory/ # Persistent strategic memory
100
+ ├── context/ # Pre-computed snapshots for fast loading
101
+ ├── templates/ # Standard formats (call-prep, call-notes, entity-teardown)
102
+ ├── research/ # Raw research files (competitors, market, technical)
103
+ ├── discovery/ # Customer/stakeholder discovery [optional]
104
+ ├── data/ # CSV/JSON source of truth
105
+ ├── skills/ # Project-level Claude Code skills
106
+ ├── dashboard/ # Live web dashboard (Vercel-deployed)
107
+ ├── docs/ # Executive summary, memos, reports
108
+ └── scripts/ # Utility scripts
109
+ ```
110
+
111
+ ---
112
+
113
+ ## What Can You Ask Claude?
114
+
115
+ Beyond the built-in skills, you can talk to Claude in plain English. The stack gives Claude the context it needs to answer strategically — your research, pipeline, decisions, and hypothesis are all loaded into memory. Here are some things you might say:
116
+
117
+ ### Research & Analysis
118
+
119
+ > "Here's my meeting transcript from the call with Acme Corp. Can you analyse this against my existing research to see what it means for our current hypothesis?"
120
+
121
+ > "Pull together everything we know about the competitive landscape and tell me where the biggest white space is."
122
+
123
+ > "I just found this industry report — read it and update our competitor research with anything new."
124
+
125
+ > "What are the strongest and weakest parts of our hypothesis right now? What evidence are we missing?"
126
+
127
+ ### Discovery & Pipeline
128
+
129
+ > "I have 3 new leads from a conference. Add them to the pipeline and draft a personalised outreach sequence for each."
130
+
131
+ > "Based on all the discovery calls so far, what patterns are emerging? Are we hearing the same pain points?"
132
+
133
+ > "Prep me for my call with Nexus Payments tomorrow — what do we know about them and what should I ask?"
134
+
135
+ ### Decision-Making
136
+
137
+ > "We need to decide between building our own data pipeline vs. using a third-party vendor. Set up a comparison with the pros, cons, and scores."
138
+
139
+ > "Play devil's advocate on our go-to-market strategy. What are we not seeing?"
140
+
141
+ > "We're about to commit to a product-led growth motion. Pressure-test this before we lock it in."
142
+
143
+ ### Reporting & Status
144
+
145
+ > "Write a 2-paragraph update I can send to the board summarising where we are this week."
146
+
147
+ > "What's changed since last Monday? Give me a diff of all research and decisions."
148
+
149
+ > "How close are we to hitting any of our kill conditions?"
150
+
151
+ These are just starting points — you can ask Claude anything about your project and it will draw on the full context of your research, pipeline, and decisions to answer.
152
+
153
+ ---
154
+
155
+ ## Project Types
156
+
157
+ The `/onboard` wizard configures the stack based on your project type:
158
+
159
+ | Type | Discovery | Pipeline | Dashboard | Best For |
160
+ |------|:---------:|:--------:|:---------:|----------|
161
+ | Market Entry | Yes | Yes | Yes | New market or product evaluation |
162
+ | Growth Strategy | Yes | Yes | Yes | Existing product, new channels or segments |
163
+ | Competitor Research | No | No | Yes | Competitive intelligence and landscape mapping |
164
+ | Product Launch / GTM | Yes | Yes | Yes | Bringing a product or feature to market |
165
+ | Internal Implementation | No | Yes | Yes | Rolling out a system, process, or initiative |
166
+ | Vendor / Partner Evaluation | Yes | Yes | Yes | Selecting tools, platforms, or partners |
167
+ | Due Diligence | Yes | Yes | Yes | M&A, investment, or acquisition evaluation |
168
+ | Business Case | No | No | Optional | Building a case for investment or change |
169
+ | Transformation / Change | Yes | Yes | Yes | Organisational or process transformation |
170
+ | Custom | Choose | Choose | Choose | Anything else |
171
+
172
+ ---
173
+
174
+ ## Requirements
175
+
176
+ - [Claude Code](https://claude.ai/code) CLI
177
+ - Node.js 18+ (for dashboard)
178
+ - Git
179
+
180
+ ---
181
+
182
+ ## Documentation
183
+
184
+ - **[Getting Started Guide](docs/getting-started.md)** — step-by-step setup for non-technical users (install, configure, deploy)
185
+ - [Dashboard Deployment](dashboard/DEPLOY.md) — quick reference for deploying to Vercel
186
+ - [Executive Summary Template](docs/executive-summary.md) — master hypothesis and strategy memo
187
+ - [Evidence Grading Rules](docs/memos/evidence-grading.md) — how claims are tagged and verified
188
+ - [Skill Authoring Guide](docs/skill-authoring-guide.md) — build your own skills for the stack
189
+ - [Dashboard Architecture](dashboard/CLAUDE.md) — how the dashboard reads, builds, and renders data
190
+
191
+ ---
192
+
193
+ ## Contributing
194
+
195
+ Contributions are welcome. Please see [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines on submitting issues, proposing features, and opening pull requests.
196
+
197
+ ---
198
+
199
+ ## Licence
200
+
201
+ MIT — see [LICENSE](LICENSE).
@@ -0,0 +1,34 @@
1
+ # Project Status Board
2
+
3
+ Lightweight coordination file. Agents update this when starting or completing work to avoid duplication.
4
+
5
+ **Last updated**: {{DATE}}
6
+
7
+ ---
8
+
9
+ ## In Progress
10
+
11
+ | Workstream | Item | Agent/Owner | Started | Notes |
12
+ |-----------|------|-------------|---------|-------|
13
+
14
+ ## Completed Recently
15
+
16
+ | Workstream | Item | Completed | Output |
17
+ |-----------|------|-----------|--------|
18
+
19
+ Older entries in `docs/output/work-log.md`.
20
+
21
+ ## Blocked / Waiting
22
+
23
+ | Item | Blocked on | Owner |
24
+ |------|-----------|-------|
25
+
26
+ ---
27
+
28
+ ## Agent Coordination Rules
29
+
30
+ 1. **Before starting work**: Check this file. If someone else is working on the same item, coordinate or pick something else.
31
+ 2. **When starting work**: Add a row to "In Progress" with your workstream, item, and start date.
32
+ 3. **When finishing work**: Move the row to "Completed Recently" and note the output file(s).
33
+ 4. **If blocked**: Add to "Blocked / Waiting" so other agents can help unblock.
34
+ 5. **Workstream labels**: `Research`, `Discovery`, `Product`, `Docs`, `Data`, `Setup`
@@ -0,0 +1,27 @@
1
+ # Competitor Snapshot — {{PROJECT_NAME}}
2
+
3
+ **Last updated**: {{DATE}}
4
+ **Regenerate after**: new competitor research, capability map changes, synthesis updates
5
+
6
+ > This snapshot is orientation for standard tasks. For strategic decisions about competitive positioning, use **Deep Mode**: read all raw files in `research/competitors/` before reasoning.
7
+
8
+ ---
9
+
10
+ ## Competitive Landscape Summary
11
+
12
+ | Competitor | Category | Overlap | Threat Level | Key Differentiator |
13
+ |-----------|----------|---------|-------------|-------------------|
14
+
15
+ ---
16
+
17
+ ## Key Competitive Gaps
18
+
19
+ <!-- What do competitors NOT do that represents your opportunity? -->
20
+
21
+ ---
22
+
23
+ ## Competitor Patterns
24
+
25
+ <!-- Emerging themes across competitors: pricing trends, feature convergence, blind spots -->
26
+
27
+ Source: `research/competitors/`, `memory/research.md`
@@ -0,0 +1,32 @@
1
+ # Market Snapshot — {{PROJECT_NAME}}
2
+
3
+ **Last updated**: {{DATE}}
4
+ **Regenerate after**: new market research, TAM updates, trend analysis
5
+
6
+ ---
7
+
8
+ ## Market Sizing
9
+
10
+ | Metric | Value | Evidence Grade |
11
+ |--------|-------|---------------|
12
+ | TAM | | |
13
+ | SAM | | |
14
+ | SOM (Y1) | | |
15
+
16
+ ---
17
+
18
+ ## Key Market Dynamics
19
+
20
+ **Tailwinds**:
21
+ -
22
+
23
+ **Headwinds**:
24
+ -
25
+
26
+ ---
27
+
28
+ ## Market Trends
29
+
30
+ <!-- Key trends affecting timing and positioning -->
31
+
32
+ Source: `research/market/`, `docs/memos/reference-context.md`
@@ -0,0 +1,36 @@
1
+ # Pipeline State Snapshot — {{PROJECT_NAME}}
2
+
3
+ > **OPTIONAL MODULE** — Include this file if your project has an outreach/pipeline component.
4
+
5
+ **Last updated**: {{DATE}}
6
+ **Regenerate after**: outreach sent, calls booked/completed, {{ENTITY_TYPE_PLURAL}} added/removed
7
+
8
+ ---
9
+
10
+ ## Pipeline Summary
11
+
12
+ - **Total {{ENTITY_TYPE_PLURAL}}**: 0
13
+ - **Active outreach**: 0
14
+ - **Calls booked**: 0
15
+ - **Calls completed**: 0
16
+
17
+ ---
18
+
19
+ ## Status Breakdown
20
+
21
+ | Status | Count | {{ENTITY_TYPE_PLURAL}} |
22
+ |--------|-------|------------------------|
23
+ | Not started | | |
24
+ | Contacted | | |
25
+ | Engaged | | |
26
+ | Meeting booked | | |
27
+ | Meeting completed | | |
28
+ | Dead | | |
29
+
30
+ ---
31
+
32
+ ## Next Actions
33
+
34
+ <!-- What outreach or follow-ups are due? -->
35
+
36
+ Source: `{{PIPELINE_SOURCE_OF_TRUTH}}`
@@ -0,0 +1,45 @@
1
+ # Project State Snapshot — {{PROJECT_NAME}}
2
+
3
+ **Last updated**: {{DATE}}
4
+ **Regenerate after**: discovery calls, kill condition changes, strategic decisions, hypothesis reviews
5
+
6
+ > This snapshot is orientation for standard tasks. For hypothesis review, critical reasoning, or strategic decisions, use **Deep Mode**: read all raw files in `discovery/calls/` and `memory/decisions.md` before reasoning. Snapshots filter; raw files contain disconfirming signals.
7
+
8
+ ---
9
+
10
+ ## Mission & Leading Hypothesis
11
+
12
+ **Mission**: {{ONE_LINE_DESCRIPTION}}
13
+ **Goal**: {{GOAL}}. Team: {{TEAM}}.
14
+
15
+ **Leading hypothesis**: {{STRATEGIC_HYPOTHESIS}}
16
+
17
+ Sources: `memory/decisions.md`, `memory/scoring.md`
18
+
19
+ ---
20
+
21
+ ## Kill Conditions
22
+
23
+ | KC | Condition | Status | Direction | Key Evidence | Source |
24
+ |----|-----------|--------|-----------|-------------|--------|
25
+
26
+ ---
27
+
28
+ ## Discovery Progress
29
+
30
+ <!-- Summary of calls completed, key findings, and pattern emerging -->
31
+
32
+ ---
33
+
34
+ ## Current Priority
35
+
36
+ <!-- What should the next session focus on? -->
37
+
38
+ ---
39
+
40
+ ## Open Risks
41
+
42
+ | # | Risk | Severity | Mitigation |
43
+ |---|------|---------|-----------|
44
+
45
+ Source: `docs/executive-summary.md` §7
@@ -0,0 +1,36 @@
1
+ # Dashboard — {{PROJECT_NAME}}
2
+
3
+ ## Architecture
4
+
5
+ The dashboard is a static site that reads project markdown/CSV files via `build-data.js` and outputs JSON consumed by browser-side JavaScript.
6
+
7
+ ```
8
+ research/competitors/*.md ──┐
9
+ memory/research.md │
10
+ memory/decisions.md │
11
+ memory/scoring.md ├──→ build-data.js ──→ dashboard/data/*.json
12
+ docs/executive-summary.md │ (reads files) (overview, entities, competitors,
13
+ docs/output/status-blurb.md │ (outputs JSON) decisions, scoring, timeline,
14
+ docs/output/work-log.md │ research)
15
+ {{PIPELINE_SOURCE_OF_TRUTH}} ┘
16
+ ```
17
+
18
+ ## Source of Truth Rules
19
+
20
+ 1. **CSV is source of truth** for {{ENTITY_TYPE}} data — add {{ENTITY_TYPE_PLURAL}} to `{{PIPELINE_SOURCE_OF_TRUTH}}` first, never only to JSON
21
+ 2. **Markdown files are source of truth** for research, status, and kill conditions
22
+ 3. **JSON files in `dashboard/data/`** are generated outputs — never edit them directly
23
+
24
+ ## Build & Deploy
25
+
26
+ - **Build**: `node build-data.js`
27
+ - **Dev**: `npm run dev` (auto-rebuilds on file changes)
28
+ - **Deploy**: Push to `main` — Vercel auto-deploys
29
+
30
+ ## Adding New Pages
31
+
32
+ 1. Create `new-page.html` using the sidebar template from `index.html`
33
+ 2. Create `js/new-page.js` with page-specific logic
34
+ 3. Add extraction logic to `build-data.js` if new data sources are needed
35
+ 4. Add nav link to the sidebar in all HTML files
36
+ 5. Rebuild: `node build-data.js`
@@ -0,0 +1,60 @@
1
+ # Dashboard Deployment
2
+
3
+ Quick reference for deploying the strategy dashboard to Vercel.
4
+
5
+ ## Prerequisites
6
+
7
+ - Node.js 18+
8
+ - A Vercel account (https://vercel.com) connected to your GitHub
9
+
10
+ ## Local Build
11
+
12
+ ```bash
13
+ cd dashboard
14
+ npm install
15
+ node build-data.js
16
+ ```
17
+
18
+ Open `index.html` in a browser to preview locally.
19
+
20
+ ## Deploy to Vercel
21
+
22
+ ### Option 1: Via Vercel Dashboard
23
+ 1. Import your GitHub repository at https://vercel.com/new
24
+ 2. Set **Root Directory** to `dashboard`
25
+ 3. Build settings are auto-detected from `vercel.json`
26
+ 4. Deploy
27
+
28
+ ### Option 2: Via Vercel CLI
29
+ ```bash
30
+ npm i -g vercel
31
+ cd dashboard
32
+ vercel
33
+ ```
34
+
35
+ ## Auto-Deploy
36
+
37
+ Once connected, every push to `main` triggers a rebuild. The `/session-end` skill commits and pushes automatically, so your dashboard stays current.
38
+
39
+ ## Configuration
40
+
41
+ `vercel.json` defines:
42
+ - **buildCommand**: `node build-data.js` — regenerates JSON from markdown/CSV
43
+ - **installCommand**: `npm install` — installs csv-parse and marked
44
+ - **outputDirectory**: `.` — serves from the dashboard root
45
+
46
+ ## Data Pipeline
47
+
48
+ ```
49
+ project root files ──→ build-data.js ──→ dashboard/data/*.json ──→ browser
50
+ ```
51
+
52
+ Build reads (read-only): `memory/*.md`, `docs/**/*.md`, `data/*.csv`, `research/**/*.md`
53
+ Build writes: `dashboard/data/overview.json`, `entities.json`, `competitors.json`, `decisions.json`, `scoring.json`, `timeline.json`, `research.json`
54
+
55
+ ## Privacy
56
+
57
+ - The deployed dashboard is **publicly accessible** by default
58
+ - Use a private GitHub repo, but note the Vercel URL is still reachable
59
+ - For confidential projects, consider Vercel's password protection (paid feature) or local-only viewing
60
+ - `robots.txt` includes `noindex, nofollow` to discourage search engine indexing