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.
- package/bin/create-dss-project.js +4 -0
- package/lib/index.js +80 -0
- package/lib/project-types.js +74 -0
- package/lib/prompts.js +42 -0
- package/lib/scaffold.js +169 -0
- package/package.json +30 -0
- package/template/.github/workflows/dashboard-build.yml +27 -0
- package/template/.github/workflows/template-lint.yml +71 -0
- package/template/CHANGELOG.md +43 -0
- package/template/CLAUDE.md +145 -0
- package/template/LICENSE +21 -0
- package/template/README.md +201 -0
- package/template/STATUS.md +34 -0
- package/template/context/competitor-snapshot.md +27 -0
- package/template/context/market-snapshot.md +32 -0
- package/template/context/pipeline-state.md +36 -0
- package/template/context/project-state.md +45 -0
- package/template/dashboard/CLAUDE.md +36 -0
- package/template/dashboard/DEPLOY.md +60 -0
- package/template/dashboard/build-data.js +395 -0
- package/template/dashboard/competitors.html +143 -0
- package/template/dashboard/css/styles.css +143 -0
- package/template/dashboard/data/.gitkeep +0 -0
- package/template/dashboard/decisions.html +132 -0
- package/template/dashboard/index.html +152 -0
- package/template/dashboard/js/app.js +59 -0
- package/template/dashboard/js/overview.js +50 -0
- package/template/dashboard/js/sidebar.js +62 -0
- package/template/dashboard/js/tailwind-config.js +52 -0
- package/template/dashboard/package-lock.json +351 -0
- package/template/dashboard/package.json +17 -0
- package/template/dashboard/pipeline.html +149 -0
- package/template/dashboard/research.html +215 -0
- package/template/dashboard/robots.txt +2 -0
- package/template/dashboard/scoring.html +187 -0
- package/template/dashboard/timeline.html +165 -0
- package/template/dashboard/vercel.json +5 -0
- package/template/dashboard/watch.js +57 -0
- package/template/data/.gitkeep +0 -0
- package/template/discovery/calls/.gitkeep +0 -0
- package/template/discovery/outreach/.gitkeep +0 -0
- package/template/discovery/prep/.gitkeep +0 -0
- package/template/docs/decks/.gitkeep +0 -0
- package/template/docs/executive-summary.md +104 -0
- package/template/docs/getting-started.md +274 -0
- package/template/docs/memos/evidence-grading.md +27 -0
- package/template/docs/memos/housekeeping-reference.md +101 -0
- package/template/docs/memos/reference-context.md +30 -0
- package/template/docs/output/project-activity.md +8 -0
- package/template/docs/output/status-blurb.md +4 -0
- package/template/docs/output/work-log.md +8 -0
- package/template/docs/skill-authoring-guide.md +212 -0
- package/template/memory/MEMORY.md +84 -0
- package/template/memory/decisions.md +13 -0
- package/template/memory/discovery.md +48 -0
- package/template/memory/research.md +33 -0
- package/template/memory/scoring.md +34 -0
- package/template/project.config.example.json +31 -0
- package/template/research/competitors/.gitkeep +0 -0
- package/template/research/market/.gitkeep +0 -0
- package/template/research/technical/.gitkeep +0 -0
- package/template/scripts/.gitkeep +0 -0
- package/template/scripts/build-cli-template.sh +32 -0
- package/template/scripts/health-check.sh +152 -0
- package/template/scripts/reset-to-template.sh +115 -0
- package/template/scripts/validate-placeholders.sh +47 -0
- package/template/skills/compare-options/SKILL.md +97 -0
- package/template/skills/critical-reasoning/SKILL.md +107 -0
- package/template/skills/decision/SKILL.md +75 -0
- package/template/skills/enrich-entity/SKILL.md +107 -0
- package/template/skills/health-check/SKILL.md +144 -0
- package/template/skills/onboard/SKILL.md +434 -0
- package/template/skills/outreach-sequence/SKILL.md +79 -0
- package/template/skills/pipeline-update/SKILL.md +90 -0
- package/template/skills/process-call/SKILL.md +96 -0
- package/template/skills/rebuild-snapshots/SKILL.md +88 -0
- package/template/skills/session-end/SKILL.md +120 -0
- package/template/skills/session-start/SKILL.md +93 -0
- package/template/skills/synthesise/SKILL.md +108 -0
- package/template/skills/weekly-report/SKILL.md +79 -0
- package/template/templates/call-notes.md +67 -0
- package/template/templates/call-prep.md +65 -0
- 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
|
package/template/LICENSE
ADDED
|
@@ -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
|
+
[](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
|
+

|
|
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
|