@curie-agent/core 0.2.4 → 0.3.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 (111) hide show
  1. package/LICENSE +179 -0
  2. package/dist/.tsbuildinfo +1 -1
  3. package/dist/src/channel-router.js +1 -1
  4. package/dist/src/channel-router.js.map +1 -1
  5. package/dist/src/context.d.ts +11 -0
  6. package/dist/src/context.d.ts.map +1 -0
  7. package/dist/src/context.js +80 -0
  8. package/dist/src/context.js.map +1 -0
  9. package/dist/src/cron-manager.d.ts +27 -8
  10. package/dist/src/cron-manager.d.ts.map +1 -1
  11. package/dist/src/cron-manager.js +121 -33
  12. package/dist/src/cron-manager.js.map +1 -1
  13. package/dist/src/event-bus.d.ts +71 -0
  14. package/dist/src/event-bus.d.ts.map +1 -1
  15. package/dist/src/event-bus.js.map +1 -1
  16. package/dist/src/heartbeat-delivery.d.ts +2 -0
  17. package/dist/src/heartbeat-delivery.d.ts.map +1 -1
  18. package/dist/src/heartbeat-delivery.js +20 -3
  19. package/dist/src/heartbeat-delivery.js.map +1 -1
  20. package/dist/src/heartbeat-executor.d.ts +36 -2
  21. package/dist/src/heartbeat-executor.d.ts.map +1 -1
  22. package/dist/src/heartbeat-executor.js +32 -40
  23. package/dist/src/heartbeat-executor.js.map +1 -1
  24. package/dist/src/identity-files.d.ts +29 -0
  25. package/dist/src/identity-files.d.ts.map +1 -0
  26. package/dist/src/identity-files.js +59 -0
  27. package/dist/src/identity-files.js.map +1 -0
  28. package/dist/src/index.d.ts +19 -4
  29. package/dist/src/index.d.ts.map +1 -1
  30. package/dist/src/index.js +13 -2
  31. package/dist/src/index.js.map +1 -1
  32. package/dist/src/pricing.d.ts +29 -0
  33. package/dist/src/pricing.d.ts.map +1 -0
  34. package/dist/src/pricing.js +85 -0
  35. package/dist/src/pricing.js.map +1 -0
  36. package/dist/src/safety/command-guard.d.ts.map +1 -1
  37. package/dist/src/safety/command-guard.js +35 -1
  38. package/dist/src/safety/command-guard.js.map +1 -1
  39. package/dist/src/safety/path-guard.d.ts +7 -3
  40. package/dist/src/safety/path-guard.d.ts.map +1 -1
  41. package/dist/src/safety/path-guard.js +14 -5
  42. package/dist/src/safety/path-guard.js.map +1 -1
  43. package/dist/src/safety/snapshot.js +1 -1
  44. package/dist/src/safety/snapshot.js.map +1 -1
  45. package/dist/src/session-store.d.ts +3 -1
  46. package/dist/src/session-store.d.ts.map +1 -1
  47. package/dist/src/session-store.js +24 -1
  48. package/dist/src/session-store.js.map +1 -1
  49. package/dist/src/settings.d.ts +98 -1
  50. package/dist/src/settings.d.ts.map +1 -1
  51. package/dist/src/settings.js +363 -83
  52. package/dist/src/settings.js.map +1 -1
  53. package/dist/src/shell-detect.d.ts +12 -0
  54. package/dist/src/shell-detect.d.ts.map +1 -0
  55. package/dist/src/shell-detect.js +31 -0
  56. package/dist/src/shell-detect.js.map +1 -0
  57. package/dist/src/subagent-executor.d.ts +68 -0
  58. package/dist/src/subagent-executor.d.ts.map +1 -0
  59. package/dist/src/subagent-executor.js +289 -0
  60. package/dist/src/subagent-executor.js.map +1 -0
  61. package/dist/src/task-executor.d.ts +31 -0
  62. package/dist/src/task-executor.d.ts.map +1 -0
  63. package/dist/src/task-executor.js +91 -0
  64. package/dist/src/task-executor.js.map +1 -0
  65. package/dist/src/task-manager.d.ts +83 -0
  66. package/dist/src/task-manager.d.ts.map +1 -0
  67. package/dist/src/task-manager.js +308 -0
  68. package/dist/src/task-manager.js.map +1 -0
  69. package/dist/src/task-migration.d.ts +10 -0
  70. package/dist/src/task-migration.d.ts.map +1 -0
  71. package/dist/src/task-migration.js +144 -0
  72. package/dist/src/task-migration.js.map +1 -0
  73. package/dist/src/task-summary.d.ts +7 -0
  74. package/dist/src/task-summary.d.ts.map +1 -0
  75. package/dist/src/task-summary.js +34 -0
  76. package/dist/src/task-summary.js.map +1 -0
  77. package/dist/src/template-utils.d.ts +16 -0
  78. package/dist/src/template-utils.d.ts.map +1 -0
  79. package/dist/src/template-utils.js +72 -0
  80. package/dist/src/template-utils.js.map +1 -0
  81. package/dist/src/token-monitor.d.ts +50 -0
  82. package/dist/src/token-monitor.d.ts.map +1 -0
  83. package/dist/src/token-monitor.js +119 -0
  84. package/dist/src/token-monitor.js.map +1 -0
  85. package/dist/src/turn-loop.d.ts +10 -1
  86. package/dist/src/turn-loop.d.ts.map +1 -1
  87. package/dist/src/turn-loop.js +152 -23
  88. package/dist/src/turn-loop.js.map +1 -1
  89. package/dist/src/unified-task.d.ts +76 -0
  90. package/dist/src/unified-task.d.ts.map +1 -0
  91. package/dist/src/unified-task.js +196 -0
  92. package/dist/src/unified-task.js.map +1 -0
  93. package/package.json +16 -11
  94. package/templates/AGENTS.md +53 -0
  95. package/templates/HEARTBEAT.md +37 -0
  96. package/templates/MEMORY.md +29 -0
  97. package/templates/SOUL.md +28 -0
  98. package/templates/TOOLS.md +29 -0
  99. package/templates/USER.md +35 -0
  100. package/templates/WIKI.md +146 -0
  101. package/templates/settings.json +90 -0
  102. package/templates/skills/deep-research/SKILL.md +273 -0
  103. package/templates/skills/deep-research/references/report-structure.md +149 -0
  104. package/templates/skills/deep-research/references/topic-guides.md +151 -0
  105. package/templates/skills/planning/SKILL.md +222 -0
  106. package/templates/skills/planning/references/business.md +82 -0
  107. package/templates/skills/planning/references/creative.md +111 -0
  108. package/templates/skills/planning/references/events.md +109 -0
  109. package/templates/skills/planning/references/personal.md +107 -0
  110. package/templates/skills/planning/references/templates.md +279 -0
  111. package/templates/skills/wiki/SKILL.md +70 -0
@@ -0,0 +1,151 @@
1
+ # Topic-Specific Research Guides
2
+
3
+ Reference this file when conducting research in specialized domains.
4
+
5
+ ---
6
+
7
+ ## Medical & Health Research
8
+
9
+ ### Best Sources
10
+ - PubMed / MEDLINE — indexed medical research papers
11
+ - Cochrane Library — systematic reviews and meta-analyses (highest quality evidence)
12
+ - WHO, CDC, NIH, NHS — institutional health guidance
13
+ - Major medical journals: NEJM, Lancet, JAMA, BMJ
14
+
15
+ ### Evidence Hierarchy (strongest → weakest)
16
+ 1. Systematic reviews & meta-analyses of randomized trials
17
+ 2. Randomized controlled trials (RCTs)
18
+ 3. Cohort studies and observational research
19
+ 4. Expert consensus / clinical guidelines
20
+ 5. Case reports, anecdotes, expert opinion
21
+
22
+ ### Key Warnings
23
+ - Single studies (even published ones) can be wrong or misleading — look for replication
24
+ - "Correlation ≠ causation" — observational studies can only suggest links
25
+ - Supplement and diet research is often industry-funded — check for conflicts of interest
26
+ - Relative risk vs absolute risk: "50% more risk" sounds alarming; "0.001% → 0.0015%" is not
27
+ - Always note: individual medical situations vary — encourage consulting a professional for personal health decisions
28
+
29
+ ### Research Pattern
30
+ Search: specific condition/treatment → look for systematic reviews → check professional guidelines → note disagreements between guidelines → identify areas of uncertainty
31
+
32
+ ---
33
+
34
+ ## Legal & Regulatory Research
35
+
36
+ ### Best Sources
37
+ - Official government websites (legislation, court rulings, regulatory agencies)
38
+ - Legal databases: Google Scholar (case law), court official websites
39
+ - Bar association publications
40
+ - Academic law journals for analysis
41
+
42
+ ### Key Principles
43
+ - **Jurisdiction matters enormously**: law varies by country, state/province, city
44
+ - **Distinguish**: statute (written law) vs case law (court interpretations) vs regulation (agency rules)
45
+ - **Currency**: laws change — always note when you found the information
46
+ - Emphasize strongly that specific legal situations require a qualified lawyer
47
+
48
+ ### Research Pattern
49
+ Identify jurisdiction → find applicable statute or regulation → find court interpretations → check for recent amendments or cases → note if the law is settled or contested
50
+
51
+ ---
52
+
53
+ ## Financial & Market Research
54
+
55
+ ### Best Sources
56
+ - SEC filings (EDGAR) for public company data in the US
57
+ - Company annual reports and investor relations pages
58
+ - Central bank publications (Federal Reserve, ECB, etc.)
59
+ - IMF, World Bank for macroeconomic data
60
+ - Established financial news: FT, WSJ, Bloomberg, Reuters
61
+ - Industry analyst reports (note: often have buy/sell conflicts)
62
+
63
+ ### Key Warnings
64
+ - Financial forecasts are often wrong — present ranges, not certainties
65
+ - Distinguish: historical data (fact) vs projections (opinion/model)
66
+ - Be explicit about who funded industry reports
67
+ - Investment advice requires professional licensing — don't make specific recommendations; present information
68
+
69
+ ### Research Pattern
70
+ Macro context → industry overview → company/asset specifics → historical performance → risks and counterarguments → expert opinion range
71
+
72
+ ---
73
+
74
+ ## Scientific & Academic Research
75
+
76
+ ### Best Sources
77
+ - Google Scholar, Semantic Scholar, arXiv (preprints)
78
+ - PubMed, IEEE Xplore (by discipline)
79
+ - University institutional repositories
80
+ - Peer-reviewed journals in the specific field
81
+
82
+ ### Key Principles
83
+ - **Preprints** (arXiv, bioRxiv) are not peer-reviewed — flag this clearly
84
+ - **Peer review is a floor, not a ceiling** — published studies still get retracted or contradicted
85
+ - Look for **replication**: single studies that haven't been replicated warrant caution
86
+ - **Effect size** matters as much as statistical significance
87
+ - Note the study's funding source and any potential conflicts of interest
88
+
89
+ ### Research Pattern
90
+ Find seminal/foundational papers → find recent systematic reviews → identify ongoing debates in the literature → look for consensus statements from scientific bodies → note open questions
91
+
92
+ ---
93
+
94
+ ## Historical Research
95
+
96
+ ### Best Sources
97
+ - Academic history books and journal articles
98
+ - National archives and libraries
99
+ - Digitized primary sources: newspapers, official documents, letters
100
+ - Encyclopedias for established facts (Wikipedia as a starting point, not endpoint)
101
+ - Oral history archives for recent history
102
+
103
+ ### Key Principles
104
+ - **Primary sources** (documents from the time) vs **secondary sources** (historians' analysis) — both are valuable, serve different purposes
105
+ - History is interpreted differently across time and perspective — note historiographical debates
106
+ - Be specific about dates, places, and actors — vagueness is a red flag in historical claims
107
+ - Distinguish between established historical consensus and revisionist interpretations
108
+
109
+ ### Research Pattern
110
+ Establish basic chronology → identify key actors and causes → find primary source evidence → read historians' interpretations → note where scholars disagree → contextualize in broader history
111
+
112
+ ---
113
+
114
+ ## Investigative & Journalistic Research
115
+
116
+ ### Best Sources
117
+ - Investigative journalism outlets: ProPublica, The Intercept, Reuters Investigates
118
+ - Public records, FOIA documents
119
+ - Court filings (PACER in the US, court websites)
120
+ - Non-profit watchdog organizations
121
+ - Academic researchers in relevant fields
122
+
123
+ ### Key Principles
124
+ - **Document everything**: note where every fact came from
125
+ - **Two-source rule**: important claims need at least two independent sources
126
+ - Distinguish **on record** (citable) vs **background** (contextual, not attributed)
127
+ - Look for **conflicts of interest** in every source — who funds them? What's their stake?
128
+ - **Follow the money**: financial records often reveal motivations
129
+
130
+ ### Research Pattern
131
+ Define the specific claim or question to investigate → find documentary evidence first → identify relevant experts and officials → search for contradicting evidence → assess source motivations → build a chain of evidence
132
+
133
+ ---
134
+
135
+ ## Technology Research
136
+
137
+ ### Best Sources
138
+ - Official documentation (for products, standards, APIs)
139
+ - Peer-reviewed computer science papers (arXiv, ACM, IEEE)
140
+ - Reputable tech journalism: Ars Technica, The Verge, Wired (for general), specialized outlets
141
+ - Company blogs (treat as primary source with obvious bias)
142
+ - GitHub repositories for open source (community reaction tells you a lot)
143
+
144
+ ### Key Warnings
145
+ - Tech moves fast — check publication dates carefully
146
+ - Vendor materials are marketing — cross-reference with independent reviews
147
+ - Benchmark results are highly context-dependent
148
+ - "AI can do X" claims often require careful reading of what "X" actually means in context
149
+
150
+ ### Research Pattern
151
+ Understand the technology category → find official specifications → find independent testing/reviews → understand limitations and failure modes → compare alternatives → check adoption and community health
@@ -0,0 +1,222 @@
1
+ ---
2
+ name: planning
3
+ description: >
4
+ Use this skill for any kind of planning task — personal, professional, creative, or logistical.
5
+ This covers a broad range: project planning, life planning, event planning, travel planning,
6
+ business strategy, goal setting, habit building, content calendars, study plans, home renovation
7
+ timelines, wedding planning, meal planning, financial planning, career planning, and more.
8
+ Trigger this skill whenever the user wants to organize actions over time, structure a complex
9
+ goal into steps, create a roadmap, break down an overwhelming task, prioritize competing demands,
10
+ or build a structured schedule or timeline. Trigger even if the request seems casual —
11
+ "help me plan my week", "I want to launch a course, where do I start", "how should I approach
12
+ renovating my kitchen", "plan a birthday party for 30 people", "I'm overwhelmed, help me organize
13
+ my life" — all of these should use this skill. This is NOT limited to software development.
14
+ ---
15
+
16
+ # Planning Skill
17
+
18
+ A universal skill for helping users create clear, actionable, and realistic plans across any domain of life or work.
19
+
20
+ ---
21
+
22
+ ## Core Philosophy
23
+
24
+ Great planning has three enemies: **vagueness**, **overwhelm**, and **rigidity**. Your job is to:
25
+ 1. Make goals concrete and outcomes measurable
26
+ 2. Break work into steps small enough to actually start
27
+ 3. Build in flexibility so the plan survives contact with reality
28
+
29
+ Always anchor the plan to the **person's actual context** — their time, energy, resources, constraints, and priorities — not an idealized version.
30
+
31
+ ---
32
+
33
+ ## Step 0: Understand Before Planning
34
+
35
+ Before writing a single bullet point, gather enough context to plan well. The key questions:
36
+
37
+ | Question | Why It Matters |
38
+ |---|---|
39
+ | What is the end goal? | Without a destination, you can't map a route |
40
+ | What does success look like? | Helps define milestones and "done" |
41
+ | What's the timeline / deadline? | Determines pace and tradeoffs |
42
+ | What resources are available? | Time, money, people, tools, energy |
43
+ | What constraints exist? | Budget limits, non-negotiables, dependencies |
44
+ | What's already been done? | Avoid re-planning what's settled |
45
+ | What's the biggest risk or unknown? | Informs where to build in buffers |
46
+
47
+ If you're missing critical info, **ask first** — one focused question at a time. Don't write a plan for the wrong goal.
48
+
49
+ ---
50
+
51
+ ## Planning Modes
52
+
53
+ Choose the right mode based on what the user needs. Often you'll combine modes.
54
+
55
+ ### 1. 🗺️ Roadmap Planning
56
+ *Use when: the user has a big goal with no clear path yet.*
57
+
58
+ - Define the end state clearly
59
+ - Work backwards to identify major milestones
60
+ - Group milestones into phases (e.g., Foundation → Build → Launch → Sustain)
61
+ - Assign rough timeframes to each phase
62
+ - Identify dependencies between milestones
63
+
64
+ **Output format**: Phased roadmap with milestones and timeframes. See `references/templates.md → Roadmap`.
65
+
66
+ ---
67
+
68
+ ### 2. 📅 Timeline / Schedule Planning
69
+ *Use when: the user has a deadline and needs to fit work into available time.*
70
+
71
+ - Anchor to the deadline and work backwards
72
+ - Identify fixed dates (events, appointments, dependencies)
73
+ - Estimate time for each task honestly — add 20–30% buffer
74
+ - Assign tasks to specific days/weeks
75
+ - Flag overloaded periods proactively
76
+
77
+ **Output format**: Week-by-week or day-by-day schedule. See `references/templates.md → Timeline`.
78
+
79
+ ---
80
+
81
+ ### 3. 🎯 Goal Decomposition
82
+ *Use when: the user has a goal but is overwhelmed and doesn't know where to start.*
83
+
84
+ - Restate the goal clearly in concrete terms
85
+ - Break it into 3–7 major outcomes needed
86
+ - For each outcome, list 3–5 specific actions
87
+ - Identify the very **first action** — make it small enough to do today
88
+ - Surface blockers and unknowns upfront
89
+
90
+ **Output format**: Goal → Outcomes → Actions tree. See `references/templates.md → Decomposition`.
91
+
92
+ ---
93
+
94
+ ### 4. 🏗️ Project Planning
95
+ *Use when: the user is managing a multi-person or multi-phase effort with deliverables.*
96
+
97
+ - Define scope: what's IN and OUT of this project
98
+ - List all deliverables
99
+ - Map dependencies between tasks
100
+ - Assign ownership (if relevant)
101
+ - Set checkpoints / review points
102
+ - Define risks and mitigations
103
+
104
+ **Output format**: Project brief + task list with owners and dates. See `references/templates.md → Project`.
105
+
106
+ ---
107
+
108
+ ### 5. 📆 Periodic Planning (Weekly / Monthly / Quarterly)
109
+ *Use when: the user wants to organize recurring time periods.*
110
+
111
+ - Review what happened last period (if known)
112
+ - Surface priorities and commitments for this period
113
+ - Allocate time blocks to categories (work, personal, health, relationships, etc.)
114
+ - Set 1–3 "wins" to aim for — not a perfect list, just top priorities
115
+ - Leave margin for the unexpected
116
+
117
+ **Output format**: Time-block schedule + top priorities list. See `references/templates.md → Periodic`.
118
+
119
+ ---
120
+
121
+ ### 6. 🎉 Event / Experience Planning
122
+ *Use when: the user is organizing an event, trip, celebration, or one-time experience.*
123
+
124
+ - Define: Who, What, When, Where, How many people, Budget
125
+ - Break into: Pre-event tasks | Day-of tasks | Post-event tasks
126
+ - Create vendor/supplier list if needed
127
+ - Build a communications plan (invites, reminders, follow-ups)
128
+ - Identify what can go wrong and have a backup
129
+
130
+ **Output format**: Event checklist with timeline. See `references/templates.md → Event`.
131
+
132
+ ---
133
+
134
+ ### 7. 🔄 Habit & Routine Planning
135
+ *Use when: the user wants to build a sustainable system, not a one-time plan.*
136
+
137
+ - Anchor new habits to existing routines (habit stacking)
138
+ - Start smaller than feels necessary — consistency > intensity
139
+ - Design the environment to reduce friction
140
+ - Define a tracking method
141
+ - Build in a weekly review moment
142
+
143
+ **Output format**: Routine design + habit tracker structure. See `references/templates.md → Habit`.
144
+
145
+ ---
146
+
147
+ ## Universal Planning Principles
148
+
149
+ Apply these regardless of the mode:
150
+
151
+ ### Prioritization
152
+ When there's more to do than time allows, help the user prioritize. Use the **Impact × Urgency** lens:
153
+ - High impact + urgent → Do first
154
+ - High impact + not urgent → Schedule deliberately (these are often neglected)
155
+ - Low impact + urgent → Delegate or batch
156
+ - Low impact + not urgent → Drop or defer
157
+
158
+ ### Buffer and Realism
159
+ - Most people underestimate time by 30–50%
160
+ - Build recovery time after intense periods
161
+ - Mark "must haves" vs "nice to haves" explicitly
162
+
163
+ ### Dependencies
164
+ - Identify what must happen *before* something else can start
165
+ - Surface these early — they're where plans collapse
166
+
167
+ ### Energy, Not Just Time
168
+ - Help the user match task type to their energy level
169
+ - Deep focus work → morning (for most people)
170
+ - Admin, email, calls → afternoon
171
+ - Creative / brainstorming → after movement or meals
172
+
173
+ ### The First Next Action
174
+ Always end with: *"What's the very first concrete action you'll take?"* This closes the loop between planning and doing.
175
+
176
+ ---
177
+
178
+ ## Output Quality Standards
179
+
180
+ A good plan output:
181
+ - Is **specific** (not "work on the project" but "draft the introduction section")
182
+ - Is **time-bound** (has dates, durations, or deadlines)
183
+ - Is **realistic** (accounts for the user's actual schedule)
184
+ - Is **actionable** (the next step is clear without more planning)
185
+ - Is **appropriately detailed** (not so granular it's overwhelming, not so vague it's useless)
186
+ - Has a **clear visual structure** (tables, phases, or numbered lists depending on content)
187
+
188
+ ---
189
+
190
+ ## Domain-Specific Guidance
191
+
192
+ For specialized domains, read the relevant reference file before planning:
193
+
194
+ | Domain | Reference File |
195
+ |---|---|
196
+ | Business / Startup / Product | `references/business.md` |
197
+ | Personal Life / Wellbeing / Career | `references/personal.md` |
198
+ | Events / Travel / Experiences | `references/events.md` |
199
+ | Learning / Education / Skill Building | `references/learning.md` |
200
+ | Creative Projects (writing, art, content) | `references/creative.md` |
201
+
202
+ ---
203
+
204
+ ## Presenting the Plan
205
+
206
+ - Use headers to separate phases or categories
207
+ - Use tables for schedules and timelines
208
+ - Use numbered lists for sequences where order matters
209
+ - Use bullet lists for non-ordered items
210
+ - Bold key dates, owners, and critical-path items
211
+ - Always end with a "Next Steps" or "Start Here" section
212
+ - Offer to adjust, drill down on a phase, or export as a document
213
+
214
+ ---
215
+
216
+ ## Anti-Patterns to Avoid
217
+
218
+ - ❌ **The Perfect Plan Trap**: Don't over-engineer. A 70% good plan that gets started beats a 100% plan that never does.
219
+ - ❌ **Planning Without Constraints**: Never ignore time, money, or energy limits — they're the whole game.
220
+ - ❌ **Front-loading Detail**: Don't plan week 6 in detail when week 1 is still unclear. Plan near-term in detail, far-term in rough strokes.
221
+ - ❌ **Missing the Human**: Always consider motivation, fear, habit, and energy — not just tasks and dates.
222
+ - ❌ **No Review Cadence**: Every plan needs a moment to check in, adapt, and course-correct.
@@ -0,0 +1,82 @@
1
+ # Business, Startup & Product Planning
2
+
3
+ Domain-specific guidance for planning in business, entrepreneurship, and product contexts.
4
+
5
+ ---
6
+
7
+ ## Business Planning Areas
8
+
9
+ ### Business / Startup Planning
10
+ Key questions:
11
+ - What problem does this solve and for whom?
12
+ - What's the business model (how does it make money)?
13
+ - What's the competitive landscape?
14
+ - What resources are needed to get to first revenue?
15
+ - What does the founding team look like?
16
+
17
+ Common phases:
18
+ 1. **Validation** — Prove the problem is real and people will pay
19
+ 2. **MVP** — Build the minimum that delivers value
20
+ 3. **Launch** — Get first paying customers
21
+ 4. **Growth** — Replicate and scale what works
22
+ 5. **Scale** — Systematize, hire, expand
23
+
24
+ Use a **lean planning approach**: 1-page plan, test assumptions fast, update often.
25
+
26
+ ### Product Planning
27
+ Key inputs needed:
28
+ - Who is the user / customer?
29
+ - What job are they trying to do?
30
+ - What are the top 3 user problems to solve?
31
+ - What's already been built vs. what's being planned?
32
+ - What's the release cadence (continuous / quarterly / etc.)?
33
+
34
+ Frameworks to apply:
35
+ - **Now / Next / Later roadmap**: Avoid fake precision on distant quarters
36
+ - **User story mapping**: Arrange features by user journey and slice by MVP
37
+ - **RICE scoring**: Reach × Impact × Confidence ÷ Effort for prioritization
38
+
39
+ ### Marketing & Launch Planning
40
+ Structure:
41
+ 1. Define target audience (be specific — not "everyone")
42
+ 2. Set launch goal (signups, revenue, press coverage, etc.)
43
+ 3. Map the customer journey (awareness → consideration → decision)
44
+ 4. Assign channels (organic, paid, email, partnerships, PR)
45
+ 5. Create content calendar
46
+ 6. Define success metrics and review cadence
47
+
48
+ ### Team & Hiring Planning
49
+ - Map current gaps to goals (what roles are missing?)
50
+ - Sequence hires by impact (what hire unlocks the most?)
51
+ - Build a realistic hiring timeline (3–4 months per senior hire)
52
+ - Plan for onboarding time (new hire ≠ productive hire immediately)
53
+
54
+ ---
55
+
56
+ ## Business Planning Frameworks
57
+
58
+ ### SWOT (quick strategic lens)
59
+ - Strengths: What advantages do you have?
60
+ - Weaknesses: Where are you vulnerable?
61
+ - Opportunities: What external factors could you exploit?
62
+ - Threats: What could undermine you?
63
+
64
+ Use SWOT for orientation, not as a plan itself.
65
+
66
+ ### North Star Metric
67
+ Pick the ONE metric that best captures the value you deliver to users. Every plan should explain how it moves this metric.
68
+
69
+ ### Working Backwards (Amazon-style)
70
+ Start with the ideal press release announcing the finished product/outcome. Then figure out what needs to be true to make it real.
71
+
72
+ ### Stage-Gate Planning
73
+ Define clear gates between phases. A project only moves to the next stage when it passes specific criteria (e.g., "10 paying customers" before building v2).
74
+
75
+ ---
76
+
77
+ ## Business Planning Anti-Patterns
78
+
79
+ - **Planning without validating assumptions**: Know which assumptions your plan depends on and test the risky ones first
80
+ - **Activity plans vs. outcome plans**: "Post 3x per week" is activity. "Reach 1,000 newsletter subscribers" is outcome. Plan for outcomes.
81
+ - **Ignoring cash flow timing**: Especially for early-stage businesses — revenue on paper ≠ cash in hand
82
+ - **Planning in isolation**: Business plans need to account for how customers, competitors, and team will actually behave
@@ -0,0 +1,111 @@
1
+ # Creative Projects & Learning Planning
2
+
3
+ ---
4
+
5
+ ## Creative Project Planning
6
+
7
+ ### Types covered
8
+ - Writing: books, blogs, newsletters, scripts, courses
9
+ - Art: illustration series, portfolio projects, exhibitions
10
+ - Content creation: YouTube channels, podcasts, social media presence
11
+ - Music: albums, EPs, live shows
12
+ - Film / video: short films, documentaries, video series
13
+
14
+ ### The Creative Planning Paradox
15
+ Creative work resists rigid planning — over-planning can kill the work. The goal is **structure that enables creativity**, not structure that replaces it.
16
+
17
+ Principles:
18
+ - Plan the **container** (deadline, output format, cadence), not the **content**
19
+ - Create consistent **work sessions** rather than linear task lists
20
+ - Build in **exploration time** (messy middle is not wasted time)
21
+ - Separate **creation mode** from **editing mode** — don't do both at once
22
+
23
+ ### Creative Project Phases
24
+
25
+ | Phase | What happens | Planning need |
26
+ |---|---|---|
27
+ | Ideation | Exploring, collecting, brainstorming | Low structure — capture everything |
28
+ | Development | Shaping the idea, defining scope | Medium — set a direction |
29
+ | Production | Making the actual work | High — consistent sessions and deadlines |
30
+ | Editing / Refinement | Polishing, iterating | Medium — structured review cycles |
31
+ | Release / Distribution | Sharing the work | High — launch planning |
32
+ | Promotion | Getting it seen | High — content calendar and outreach |
33
+
34
+ ### Content Calendar Planning
35
+ Key decisions:
36
+ - Format (video, written, audio, visual)?
37
+ - Frequency (daily, weekly, bi-weekly)?
38
+ - Topics / themes per month?
39
+ - Production lead time (record → edit → publish pipeline)?
40
+
41
+ **Batching principle**: Create in batches, not one at a time. Record 4 episodes at once. Write 3 posts in one session.
42
+
43
+ ### Book / Long-form Writing Planning
44
+ 1. **Concept phase**: What is this book *about* at its core? Who is it for?
45
+ 2. **Outline phase**: Chapter map, each chapter's argument / arc
46
+ 3. **First draft**: Set a daily word count goal (500–2000 words/day is typical)
47
+ 4. **Rest**: Leave the draft for at least 1–2 weeks before editing
48
+ 5. **Revision cycles**: Structure → argument → prose → copy
49
+ 6. **Publishing path**: Traditional (query agents) vs. self-publishing (platform choice)
50
+
51
+ ---
52
+
53
+ ## Learning & Skill-Building Planning
54
+
55
+ ### Types covered
56
+ - Learning a new language
57
+ - Preparing for a certification or exam
58
+ - Building a technical skill (coding, design, data analysis)
59
+ - Developing a professional skill (public speaking, negotiation, management)
60
+ - Picking up a hobby skill (instrument, sport, craft)
61
+
62
+ ### Key inputs needed
63
+ - What level are you starting from?
64
+ - What level do you need / want to reach?
65
+ - How will you know you've succeeded?
66
+ - How much time per week can you consistently give?
67
+ - Is there a deadline (exam date, job interview, performance)?
68
+
69
+ ### Learning Plan Structure
70
+
71
+ **Phase 1: Orientation (1–2 weeks)**
72
+ - Survey the landscape — what's involved?
73
+ - Identify the best resources (course, book, mentor, practice tool)
74
+ - Set a realistic timeline based on time available
75
+
76
+ **Phase 2: Foundational learning**
77
+ - Core concepts and vocabulary
78
+ - Low-stakes practice — making mistakes is the goal here
79
+ - Progress tracking (not to judge, but to motivate)
80
+
81
+ **Phase 3: Applied practice**
82
+ - Real-world application of what you're learning
83
+ - Projects, conversations, performances — output matters more than input
84
+ - Deliberate practice on weak areas (not just comfortable repetition)
85
+
86
+ **Phase 4: Consolidation**
87
+ - Review and spaced repetition
88
+ - Test under pressure (mock exams, presentations, live conversations)
89
+ - Identify remaining gaps and target them
90
+
91
+ ### Learning Planning Principles
92
+
93
+ **Active > Passive**: Reading about something ≠ learning it. Plan for more *doing* than *consuming*.
94
+
95
+ **Spaced repetition**: Review material at increasing intervals (day 1, day 3, day 7, day 21) — don't cram.
96
+
97
+ **The 20% rule**: 20% of concepts produce 80% of real-world results. Identify the core and prioritize ruthlessly.
98
+
99
+ **Accountability**: A study partner, coach, class, or public commitment dramatically improves follow-through.
100
+
101
+ **Input → Output ratio**: For language learning and most skills, aim for 1:1 or more time producing vs. consuming.
102
+
103
+ ### Exam / Certification Prep Plan
104
+ | Phase | Timing | Focus |
105
+ |---|---|---|
106
+ | Assessment | 8–12 weeks out | Take a full practice test cold to find gaps |
107
+ | Content review | 6–10 weeks out | Study weak areas, not what you already know |
108
+ | Practice problems | 4–6 weeks out | Do timed practice sets daily |
109
+ | Mock exams | 2–3 weeks out | Full-length tests under real conditions |
110
+ | Light review | Final week | Review notes only, protect sleep and energy |
111
+ | Exam day | — | Arrive early, eat well, no new material |
@@ -0,0 +1,109 @@
1
+ # Event, Travel & Experience Planning
2
+
3
+ ---
4
+
5
+ ## Event Planning
6
+
7
+ ### Types covered
8
+ - Weddings and engagements
9
+ - Birthday parties, anniversaries, celebrations
10
+ - Corporate events, team offsites, retreats
11
+ - Conferences, workshops, meetups
12
+ - Funerals, memorial services (approached with extra care and brevity)
13
+
14
+ ### Key inputs needed
15
+ - Date(s) and flexibility around them
16
+ - Headcount (confirmed vs. estimated)
17
+ - Budget (total and any category limits)
18
+ - Location preferences (city, venue type, indoor/outdoor)
19
+ - Tone / vibe (formal, casual, themed, intimate, large)
20
+ - Key constraints (dietary, accessibility, cultural)
21
+
22
+ ### Planning Timeline (work backwards from event date)
23
+ | Lead time | Work to do |
24
+ |---|---|
25
+ | 12+ months | Venue booking (for large events), rough guest list |
26
+ | 6–9 months | Vendors (caterer, photographer, music), save-the-dates |
27
+ | 3–6 months | Invitations, catering menu, accommodation blocks |
28
+ | 1–3 months | Final RSVPs, seating, day-of schedule |
29
+ | 2–4 weeks | Final confirmations, vendor briefing, run-of-show |
30
+ | 1 week | Print items, transport, last-minute details |
31
+ | Day before | Pack, setup, delegate tasks |
32
+
33
+ ### Delegation principle
34
+ For large events: identify 2–3 people who can own specific domains (logistics, communications, day-of coordination). Don't plan alone.
35
+
36
+ ---
37
+
38
+ ## Travel Planning
39
+
40
+ ### Types covered
41
+ - Solo travel, couple trips, family holidays
42
+ - Budget backpacking, luxury travel, group tours
43
+ - City breaks, road trips, international adventures
44
+ - Business travel
45
+
46
+ ### Key inputs needed
47
+ - Destination (fixed or open to suggestion?)
48
+ - Travel dates and duration
49
+ - Budget (total, or daily range)
50
+ - Travelers (number, ages, needs, energy level)
51
+ - Travel style (fast-paced / relaxed, structured / spontaneous)
52
+ - Non-negotiables (things they must do or see)
53
+ - Constraints (visa requirements, health considerations, mobility)
54
+
55
+ ### Trip Planning Structure
56
+
57
+ **Phase 1: Framework (before booking)**
58
+ - Choose destination and dates
59
+ - Set total budget breakdown: flights + accommodation + food + activities + misc
60
+ - Book flights (price usually peaks 4–6 weeks before departure)
61
+ - Book accommodation (especially if peak season)
62
+
63
+ **Phase 2: Itinerary Design**
64
+ - Map geography first — group nearby places together to avoid backtracking
65
+ - Plan 2–3 things per day maximum (leave room for discovery)
66
+ - Alternate high-energy and low-energy days
67
+ - Build 1 fully free day per week of travel
68
+
69
+ **Phase 3: Logistics**
70
+ - Transport between destinations
71
+ - Local transport options (transit passes, rental car, bike)
72
+ - Restaurant and activity reservations (only for must-dos)
73
+ - Packing list (climate, activities, trip length)
74
+
75
+ **Phase 4: Day-of Prep**
76
+ - Confirmation numbers and offline access
77
+ - Emergency contacts
78
+ - Travel insurance details
79
+ - Currency and payment methods
80
+
81
+ ### Sample Day Structure (for city travel)
82
+ ```
83
+ Morning: 1 major attraction or neighborhood (low crowds)
84
+ Midday: Lunch, rest, flexible time
85
+ Afternoon: 1–2 lighter activities or wandering
86
+ Evening: Dinner reservation (only book 1 per day max)
87
+ ```
88
+
89
+ ### Travel Anti-Patterns
90
+ - Overpacking the itinerary (travel fatigue is real)
91
+ - Not accounting for travel time between places
92
+ - Only booking dinners, not lunches (best meal of the day!)
93
+ - Skipping travel insurance
94
+ - No offline maps / downloaded content
95
+
96
+ ---
97
+
98
+ ## Experience & Creative Events
99
+
100
+ ### Surprise parties, themed experiences, scavenger hunts
101
+ - Build the reveal / moment as the anchor, then work backwards
102
+ - Identify who can help and what needs to stay secret
103
+ - Run two tracks: what guests experience vs. what organizers know
104
+
105
+ ### Workshops and Learning Events
106
+ - Define learning outcome first ("Attendees will be able to X")
107
+ - Design experience in segments: open → explore → practice → reflect → apply
108
+ - Build in breaks (max 90 min uninterrupted)
109
+ - Prepare for technical failure (always have offline backup)