@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.
- package/LICENSE +179 -0
- package/dist/.tsbuildinfo +1 -1
- package/dist/src/channel-router.js +1 -1
- package/dist/src/channel-router.js.map +1 -1
- package/dist/src/context.d.ts +11 -0
- package/dist/src/context.d.ts.map +1 -0
- package/dist/src/context.js +80 -0
- package/dist/src/context.js.map +1 -0
- package/dist/src/cron-manager.d.ts +27 -8
- package/dist/src/cron-manager.d.ts.map +1 -1
- package/dist/src/cron-manager.js +121 -33
- package/dist/src/cron-manager.js.map +1 -1
- package/dist/src/event-bus.d.ts +71 -0
- package/dist/src/event-bus.d.ts.map +1 -1
- package/dist/src/event-bus.js.map +1 -1
- package/dist/src/heartbeat-delivery.d.ts +2 -0
- package/dist/src/heartbeat-delivery.d.ts.map +1 -1
- package/dist/src/heartbeat-delivery.js +20 -3
- package/dist/src/heartbeat-delivery.js.map +1 -1
- package/dist/src/heartbeat-executor.d.ts +36 -2
- package/dist/src/heartbeat-executor.d.ts.map +1 -1
- package/dist/src/heartbeat-executor.js +32 -40
- package/dist/src/heartbeat-executor.js.map +1 -1
- package/dist/src/identity-files.d.ts +29 -0
- package/dist/src/identity-files.d.ts.map +1 -0
- package/dist/src/identity-files.js +59 -0
- package/dist/src/identity-files.js.map +1 -0
- package/dist/src/index.d.ts +19 -4
- package/dist/src/index.d.ts.map +1 -1
- package/dist/src/index.js +13 -2
- package/dist/src/index.js.map +1 -1
- package/dist/src/pricing.d.ts +29 -0
- package/dist/src/pricing.d.ts.map +1 -0
- package/dist/src/pricing.js +85 -0
- package/dist/src/pricing.js.map +1 -0
- package/dist/src/safety/command-guard.d.ts.map +1 -1
- package/dist/src/safety/command-guard.js +35 -1
- package/dist/src/safety/command-guard.js.map +1 -1
- package/dist/src/safety/path-guard.d.ts +7 -3
- package/dist/src/safety/path-guard.d.ts.map +1 -1
- package/dist/src/safety/path-guard.js +14 -5
- package/dist/src/safety/path-guard.js.map +1 -1
- package/dist/src/safety/snapshot.js +1 -1
- package/dist/src/safety/snapshot.js.map +1 -1
- package/dist/src/session-store.d.ts +3 -1
- package/dist/src/session-store.d.ts.map +1 -1
- package/dist/src/session-store.js +24 -1
- package/dist/src/session-store.js.map +1 -1
- package/dist/src/settings.d.ts +98 -1
- package/dist/src/settings.d.ts.map +1 -1
- package/dist/src/settings.js +363 -83
- package/dist/src/settings.js.map +1 -1
- package/dist/src/shell-detect.d.ts +12 -0
- package/dist/src/shell-detect.d.ts.map +1 -0
- package/dist/src/shell-detect.js +31 -0
- package/dist/src/shell-detect.js.map +1 -0
- package/dist/src/subagent-executor.d.ts +68 -0
- package/dist/src/subagent-executor.d.ts.map +1 -0
- package/dist/src/subagent-executor.js +289 -0
- package/dist/src/subagent-executor.js.map +1 -0
- package/dist/src/task-executor.d.ts +31 -0
- package/dist/src/task-executor.d.ts.map +1 -0
- package/dist/src/task-executor.js +91 -0
- package/dist/src/task-executor.js.map +1 -0
- package/dist/src/task-manager.d.ts +83 -0
- package/dist/src/task-manager.d.ts.map +1 -0
- package/dist/src/task-manager.js +308 -0
- package/dist/src/task-manager.js.map +1 -0
- package/dist/src/task-migration.d.ts +10 -0
- package/dist/src/task-migration.d.ts.map +1 -0
- package/dist/src/task-migration.js +144 -0
- package/dist/src/task-migration.js.map +1 -0
- package/dist/src/task-summary.d.ts +7 -0
- package/dist/src/task-summary.d.ts.map +1 -0
- package/dist/src/task-summary.js +34 -0
- package/dist/src/task-summary.js.map +1 -0
- package/dist/src/template-utils.d.ts +16 -0
- package/dist/src/template-utils.d.ts.map +1 -0
- package/dist/src/template-utils.js +72 -0
- package/dist/src/template-utils.js.map +1 -0
- package/dist/src/token-monitor.d.ts +50 -0
- package/dist/src/token-monitor.d.ts.map +1 -0
- package/dist/src/token-monitor.js +119 -0
- package/dist/src/token-monitor.js.map +1 -0
- package/dist/src/turn-loop.d.ts +10 -1
- package/dist/src/turn-loop.d.ts.map +1 -1
- package/dist/src/turn-loop.js +152 -23
- package/dist/src/turn-loop.js.map +1 -1
- package/dist/src/unified-task.d.ts +76 -0
- package/dist/src/unified-task.d.ts.map +1 -0
- package/dist/src/unified-task.js +196 -0
- package/dist/src/unified-task.js.map +1 -0
- package/package.json +16 -11
- package/templates/AGENTS.md +53 -0
- package/templates/HEARTBEAT.md +37 -0
- package/templates/MEMORY.md +29 -0
- package/templates/SOUL.md +28 -0
- package/templates/TOOLS.md +29 -0
- package/templates/USER.md +35 -0
- package/templates/WIKI.md +146 -0
- package/templates/settings.json +90 -0
- package/templates/skills/deep-research/SKILL.md +273 -0
- package/templates/skills/deep-research/references/report-structure.md +149 -0
- package/templates/skills/deep-research/references/topic-guides.md +151 -0
- package/templates/skills/planning/SKILL.md +222 -0
- package/templates/skills/planning/references/business.md +82 -0
- package/templates/skills/planning/references/creative.md +111 -0
- package/templates/skills/planning/references/events.md +109 -0
- package/templates/skills/planning/references/personal.md +107 -0
- package/templates/skills/planning/references/templates.md +279 -0
- 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)
|