@curie-agent/core 0.2.5 → 0.3.3

package/templates/skills/planning/references/creative.md

@@ -0,0 +1,111 @@
+# Creative Projects & Learning Planning
+
+---
+
+## Creative Project Planning
+
+### Types covered
+- Writing: books, blogs, newsletters, scripts, courses
+- Art: illustration series, portfolio projects, exhibitions
+- Content creation: YouTube channels, podcasts, social media presence
+- Music: albums, EPs, live shows
+- Film / video: short films, documentaries, video series
+
+### The Creative Planning Paradox
+Creative work resists rigid planning — over-planning can kill the work. The goal is **structure that enables creativity**, not structure that replaces it.
+
+Principles:
+- Plan the **container** (deadline, output format, cadence), not the **content**
+- Create consistent **work sessions** rather than linear task lists
+- Build in **exploration time** (messy middle is not wasted time)
+- Separate **creation mode** from **editing mode** — don't do both at once
+
+### Creative Project Phases
+
+| Phase | What happens | Planning need |
+|---|---|---|
+| Ideation | Exploring, collecting, brainstorming | Low structure — capture everything |
+| Development | Shaping the idea, defining scope | Medium — set a direction |
+| Production | Making the actual work | High — consistent sessions and deadlines |
+| Editing / Refinement | Polishing, iterating | Medium — structured review cycles |
+| Release / Distribution | Sharing the work | High — launch planning |
+| Promotion | Getting it seen | High — content calendar and outreach |
+
+### Content Calendar Planning
+Key decisions:
+- Format (video, written, audio, visual)?
+- Frequency (daily, weekly, bi-weekly)?
+- Topics / themes per month?
+- Production lead time (record → edit → publish pipeline)?
+
+**Batching principle**: Create in batches, not one at a time. Record 4 episodes at once. Write 3 posts in one session.
+
+### Book / Long-form Writing Planning
+1. **Concept phase**: What is this book *about* at its core? Who is it for?
+2. **Outline phase**: Chapter map, each chapter's argument / arc
+3. **First draft**: Set a daily word count goal (500–2000 words/day is typical)
+4. **Rest**: Leave the draft for at least 1–2 weeks before editing
+5. **Revision cycles**: Structure → argument → prose → copy
+6. **Publishing path**: Traditional (query agents) vs. self-publishing (platform choice)
+
+---
+
+## Learning & Skill-Building Planning
+
+### Types covered
+- Learning a new language
+- Preparing for a certification or exam
+- Building a technical skill (coding, design, data analysis)
+- Developing a professional skill (public speaking, negotiation, management)
+- Picking up a hobby skill (instrument, sport, craft)
+
+### Key inputs needed
+- What level are you starting from?
+- What level do you need / want to reach?
+- How will you know you've succeeded?
+- How much time per week can you consistently give?
+- Is there a deadline (exam date, job interview, performance)?
+
+### Learning Plan Structure
+
+**Phase 1: Orientation (1–2 weeks)**
+- Survey the landscape — what's involved?
+- Identify the best resources (course, book, mentor, practice tool)
+- Set a realistic timeline based on time available
+
+**Phase 2: Foundational learning**
+- Core concepts and vocabulary
+- Low-stakes practice — making mistakes is the goal here
+- Progress tracking (not to judge, but to motivate)
+
+**Phase 3: Applied practice**
+- Real-world application of what you're learning
+- Projects, conversations, performances — output matters more than input
+- Deliberate practice on weak areas (not just comfortable repetition)
+
+**Phase 4: Consolidation**
+- Review and spaced repetition
+- Test under pressure (mock exams, presentations, live conversations)
+- Identify remaining gaps and target them
+
+### Learning Planning Principles
+
+**Active > Passive**: Reading about something ≠ learning it. Plan for more *doing* than *consuming*.
+
+**Spaced repetition**: Review material at increasing intervals (day 1, day 3, day 7, day 21) — don't cram.
+
+**The 20% rule**: 20% of concepts produce 80% of real-world results. Identify the core and prioritize ruthlessly.
+
+**Accountability**: A study partner, coach, class, or public commitment dramatically improves follow-through.
+
+**Input → Output ratio**: For language learning and most skills, aim for 1:1 or more time producing vs. consuming.
+
+### Exam / Certification Prep Plan
+| Phase | Timing | Focus |
+|---|---|---|
+| Assessment | 8–12 weeks out | Take a full practice test cold to find gaps |
+| Content review | 6–10 weeks out | Study weak areas, not what you already know |
+| Practice problems | 4–6 weeks out | Do timed practice sets daily |
+| Mock exams | 2–3 weeks out | Full-length tests under real conditions |
+| Light review | Final week | Review notes only, protect sleep and energy |
+| Exam day | — | Arrive early, eat well, no new material |

package/templates/skills/planning/references/events.md

@@ -0,0 +1,109 @@
+# Event, Travel & Experience Planning
+
+---
+
+## Event Planning
+
+### Types covered
+- Weddings and engagements
+- Birthday parties, anniversaries, celebrations
+- Corporate events, team offsites, retreats
+- Conferences, workshops, meetups
+- Funerals, memorial services (approached with extra care and brevity)
+
+### Key inputs needed
+- Date(s) and flexibility around them
+- Headcount (confirmed vs. estimated)
+- Budget (total and any category limits)
+- Location preferences (city, venue type, indoor/outdoor)
+- Tone / vibe (formal, casual, themed, intimate, large)
+- Key constraints (dietary, accessibility, cultural)
+
+### Planning Timeline (work backwards from event date)
+| Lead time | Work to do |
+|---|---|
+| 12+ months | Venue booking (for large events), rough guest list |
+| 6–9 months | Vendors (caterer, photographer, music), save-the-dates |
+| 3–6 months | Invitations, catering menu, accommodation blocks |
+| 1–3 months | Final RSVPs, seating, day-of schedule |
+| 2–4 weeks | Final confirmations, vendor briefing, run-of-show |
+| 1 week | Print items, transport, last-minute details |
+| Day before | Pack, setup, delegate tasks |
+
+### Delegation principle
+For large events: identify 2–3 people who can own specific domains (logistics, communications, day-of coordination). Don't plan alone.
+
+---
+
+## Travel Planning
+
+### Types covered
+- Solo travel, couple trips, family holidays
+- Budget backpacking, luxury travel, group tours
+- City breaks, road trips, international adventures
+- Business travel
+
+### Key inputs needed
+- Destination (fixed or open to suggestion?)
+- Travel dates and duration
+- Budget (total, or daily range)
+- Travelers (number, ages, needs, energy level)
+- Travel style (fast-paced / relaxed, structured / spontaneous)
+- Non-negotiables (things they must do or see)
+- Constraints (visa requirements, health considerations, mobility)
+
+### Trip Planning Structure
+
+**Phase 1: Framework (before booking)**
+- Choose destination and dates
+- Set total budget breakdown: flights + accommodation + food + activities + misc
+- Book flights (price usually peaks 4–6 weeks before departure)
+- Book accommodation (especially if peak season)
+
+**Phase 2: Itinerary Design**
+- Map geography first — group nearby places together to avoid backtracking
+- Plan 2–3 things per day maximum (leave room for discovery)
+- Alternate high-energy and low-energy days
+- Build 1 fully free day per week of travel
+
+**Phase 3: Logistics**
+- Transport between destinations
+- Local transport options (transit passes, rental car, bike)
+- Restaurant and activity reservations (only for must-dos)
+- Packing list (climate, activities, trip length)
+
+**Phase 4: Day-of Prep**
+- Confirmation numbers and offline access
+- Emergency contacts
+- Travel insurance details
+- Currency and payment methods
+
+### Sample Day Structure (for city travel)
+```
+Morning:  1 major attraction or neighborhood (low crowds)
+Midday:   Lunch, rest, flexible time
+Afternoon: 1–2 lighter activities or wandering
+Evening:  Dinner reservation (only book 1 per day max)
+```
+
+### Travel Anti-Patterns
+- Overpacking the itinerary (travel fatigue is real)
+- Not accounting for travel time between places
+- Only booking dinners, not lunches (best meal of the day!)
+- Skipping travel insurance
+- No offline maps / downloaded content
+
+---
+
+## Experience & Creative Events
+
+### Surprise parties, themed experiences, scavenger hunts
+- Build the reveal / moment as the anchor, then work backwards
+- Identify who can help and what needs to stay secret
+- Run two tracks: what guests experience vs. what organizers know
+
+### Workshops and Learning Events
+- Define learning outcome first ("Attendees will be able to X")
+- Design experience in segments: open → explore → practice → reflect → apply
+- Build in breaks (max 90 min uninterrupted)
+- Prepare for technical failure (always have offline backup)

package/templates/skills/planning/references/personal.md

@@ -0,0 +1,107 @@
+# Personal Life, Career & Wellbeing Planning
+
+Domain-specific guidance for planning tasks in the personal sphere.
+
+---
+
+## Personal Life Planning Areas
+
+### Career Planning
+Key questions to ask:
+- Where do you want to be in 1 year / 3 years / 5 years?
+- What skills are required to get there?
+- What's missing from your current role or path?
+- Are you optimizing for: money, growth, impact, lifestyle, stability — or some mix?
+
+Framework: **Ikigai lens** — what you love, what you're good at, what the world needs, what you can be paid for.
+
+Plan structure:
+1. Current state assessment (skills, experience, network, gaps)
+2. Target role / state definition
+3. Gap analysis
+4. Milestones: certifications, projects, roles, conversations
+5. 90-day action plan (most important horizon)
+
+### Financial Planning
+> Note: You're not a financial advisor. Help with structure and process, not specific investment or tax advice.
+
+Key areas to help plan:
+- Budgeting: income vs. expenses categories
+- Debt payoff ordering (avalanche / snowball method)
+- Savings goals with target dates and monthly contribution
+- Emergency fund building
+- Big purchase planning (home, car, travel)
+
+Framework: **50/30/20 rule** (needs / wants / savings) as a starting structure, adjusted for the person.
+
+### Health & Fitness Planning
+Key questions:
+- What is the goal? (lose weight, build strength, run a race, improve energy, manage stress)
+- Current baseline? (activity level, sleep, diet habits)
+- How much time per week is realistic?
+- Any injuries or constraints?
+
+Principles:
+- Specificity: "exercise more" → "3x 45-min strength sessions per week"
+- Progressive overload for fitness goals
+- Habit pairing: anchor workouts to existing anchors (commute, lunch)
+- Recovery is part of the plan — don't ignore it
+
+### Relationship & Family Planning
+(Wedding planning, family events, parenting goals, social life)
+
+Key considerations:
+- Shared vs. individual priorities
+- Communication and alignment between people involved
+- Logistics (travel, costs, coordination)
+- Emotional load and decision fatigue
+
+Keep plans practical, not prescriptive about values.
+
+### Home & Living Planning
+(Moving, renovation, decluttering, purchase decisions)
+
+Renovation / home project structure:
+1. Define scope and must-haves vs. nice-to-haves
+2. Set budget with 15–20% contingency
+3. Get quotes before committing to timeline
+4. Sequence work correctly (structural → plumbing/electrical → surfaces → finishes)
+5. Plan for disruption to daily life during work
+
+---
+
+## Personal Planning Anti-Patterns
+
+- **Planning for your ideal self**: Plan for who you are now, not who you wish you were
+- **Ignoring energy and motivation**: Calendar time ≠ productive time
+- **No review moment**: Personal plans need a weekly or monthly check-in
+- **Too many goals at once**: Pick 1–3 major focus areas per quarter maximum
+- **Planning instead of deciding**: Sometimes the blocker isn't a missing plan, it's an avoided decision
+
+---
+
+## Useful Frameworks for Personal Planning
+
+### The 12-Week Year
+Treat every 12 weeks as a full "year." Set 1–3 goals, plan weekly execution, review at week 13.
+Good for: people who procrastinate until year-end deadlines.
+
+### OKRs (Objectives & Key Results)
+- Objective: Qualitative, inspiring goal
+- Key Results: 2–4 measurable outcomes that prove the objective was met
+Good for: people who need clear measurement.
+
+### Time Blocking
+Assign categories of activity to fixed time slots before the week starts.
+Good for: people who lose time to reactive tasks.
+
+### The One Thing
+Ask: "What's the ONE thing I could do, such that by doing it, everything else becomes easier or unnecessary?"
+Good for: people who are overwhelmed and stuck.
+
+### WOOP (Wish, Outcome, Obstacle, Plan)
+1. Wish: What do you want?
+2. Outcome: What would it feel like to achieve it?
+3. Obstacle: What's the main thing that could get in the way?
+4. Plan: If [obstacle], then I will [action].
+Good for: behavior change and habit formation.

package/templates/skills/planning/references/templates.md

@@ -0,0 +1,279 @@
+# Planning Templates
+
+Output templates for each planning mode. Use these as structural guides — adapt to the user's context.
+
+---
+
+## Roadmap Template
+
+```
+# [Goal Name] Roadmap
+
+**Goal**: [One sentence — what does done look like?]
+**Timeframe**: [Start → End]
+**Owner(s)**: [Who is responsible]
+
+---
+
+## Phase 1: [Phase Name] — [Month/Week range]
+**Objective**: [What this phase achieves]
+
+Milestones:
+- [ ] [Milestone 1] — [target date]
+- [ ] [Milestone 2] — [target date]
+- [ ] [Milestone 3] — [target date]
+
+Key risks: [What could go wrong in this phase]
+
+---
+
+## Phase 2: [Phase Name] — [Month/Week range]
+...
+
+---
+
+## Success Metrics
+- [How will you know you've achieved the goal?]
+
+## Review Cadence
+- [When and how will you check progress?]
+```
+
+---
+
+## Timeline Template
+
+```
+# [Project/Goal] Timeline
+
+**Deadline**: [Date]
+**Today**: [Date]
+**Time available**: [X weeks / days]
+
+---
+
+| Week / Date | Tasks | Time needed | Notes |
+|---|---|---|---|
+| Week 1 (dates) | Task A, Task B | ~X hrs | [context] |
+| Week 2 (dates) | Task C | ~X hrs | Depends on Task A |
+| ... | | | |
+| Final week | Review, polish, submit | ~X hrs | Buffer built in |
+
+---
+
+**Critical path** (must not slip): [List items that block everything else]
+**Buffers**: [Where you've built in slack]
+**First action**: [What to do today]
+```
+
+---
+
+## Goal Decomposition Template
+
+```
+# Breaking Down: [Goal]
+
+**Goal stated clearly**: [Concrete version of the goal]
+**Why this matters**: [The user's motivation — keeps them going]
+**Deadline / horizon**: [When]
+
+---
+
+## Outcome 1: [Major outcome needed]
+Actions:
+1. [Specific action]
+2. [Specific action]
+3. [Specific action]
+
+## Outcome 2: [Major outcome needed]
+Actions:
+1. ...
+
+---
+
+## Blockers & Unknowns
+- [What do you need to figure out before you can move?]
+- [What might stop you?]
+
+## Start Here
+→ **First action (do this today/this week)**: [One clear, small, concrete action]
+```
+
+---
+
+## Project Template
+
+```
+# [Project Name]
+
+**Purpose**: [Why this project exists]
+**Owner**: [Who leads it]
+**Team**: [Who else is involved and in what role]
+**Start**: [Date] | **End**: [Date]
+**Budget**: [If applicable]
+
+---
+
+## Scope
+**In scope**: [What this project includes]
+**Out of scope**: [What it explicitly doesn't cover]
+
+---
+
+## Deliverables
+| Deliverable | Owner | Due Date | Status |
+|---|---|---|---|
+| [e.g. Draft report] | [Name] | [Date] | Not started |
+| ... | | | |
+
+---
+
+## Task Breakdown
+### Phase 1: [Name]
+- [ ] [Task] — [Owner] — [Due]
+- [ ] [Task] — [Owner] — [Due]
+
+### Phase 2: [Name]
+- [ ] ...
+
+---
+
+## Dependencies
+- [Task B] cannot start until [Task A] is done
+- [Milestone X] requires sign-off from [Person]
+
+---
+
+## Risks
+| Risk | Likelihood | Impact | Mitigation |
+|---|---|---|---|
+| [Risk description] | High/Med/Low | High/Med/Low | [How to reduce it] |
+
+---
+
+## Checkpoints
+- [Date]: [What will be reviewed]
+- [Date]: [Go/no-go decision]
+```
+
+---
+
+## Periodic Planning Template (Weekly)
+
+```
+# Week of [Date]
+
+## Carried over from last week
+- [What didn't get done that still matters]
+
+## Fixed commitments this week
+- [Meeting / appointment / deadline — Mon]
+- [...]
+
+## Top 3 priorities (must happen this week)
+1. [Priority 1]
+2. [Priority 2]
+3. [Priority 3]
+
+## Other tasks (do if time allows)
+- [Task]
+- [Task]
+
+## Time blocks
+| Day | Morning | Afternoon | Evening |
+|---|---|---|---|
+| Mon | [Deep work: X] | [Calls/admin] | [Personal] |
+| Tue | ... | | |
+| ... | | | |
+
+## This week I'll call it a win if...
+[One sentence — the most important thing that could happen]
+```
+
+---
+
+## Event Planning Template
+
+```
+# [Event Name]
+
+**Date**: [Date] | **Time**: [Time]
+**Location**: [Venue / address / online link]
+**Attendees**: [Number and who]
+**Budget**: [Total] | **Spent so far**: [Amount]
+
+---
+
+## Pre-Event Tasks
+| Task | Owner | Deadline | Done? |
+|---|---|---|---|
+| Book venue | [Name] | [Date] | ☐ |
+| Send invitations | | | ☐ |
+| Confirm catering | | | ☐ |
+| Arrange transport | | | ☐ |
+| ... | | | |
+
+## Day-Of Tasks
+| Time | Task | Owner |
+|---|---|---|
+| [Time] | Setup / arrival | |
+| [Time] | Guests arrive | |
+| [Time] | [Activity] | |
+| [Time] | Wrap-up / cleanup | |
+
+## Post-Event
+- [ ] Send thank-you notes / follow-ups
+- [ ] Collect feedback
+- [ ] Settle final invoices
+- [ ] [Other]
+
+## Backup Plans
+- If [X goes wrong]: [fallback]
+- If weather is bad: [fallback]
+```
+
+---
+
+## Habit & Routine Template
+
+```
+# [Habit / Routine Name]
+
+**Goal**: [What this routine is designed to achieve]
+**Duration**: [How long each session] | **Frequency**: [Daily / 3x week / etc.]
+**Starting small**: [The minimum viable version to build from]
+
+---
+
+## Routine Design
+
+### Morning Routine — [Total time: X min]
+| Time | Action | Duration |
+|---|---|---|
+| [Time] | Wake up, water | 5 min |
+| [Time] | [Habit 1] | [X] min |
+| [Time] | [Habit 2] | [X] min |
+| [Time] | [Leave / start work] | — |
+
+### Evening Routine — [Total time: X min]
+| Time | Action | Duration |
+|---|---|---|
+| ... | | |
+
+---
+
+## Habit Stacks
+[New habit] → After [existing habit]
+Example: "After I pour my morning coffee → I open my journal"
+
+## Environment Design
+- [Remove friction]: [e.g., lay out gym clothes the night before]
+- [Add cue]: [e.g., put book on pillow so I see it at night]
+
+## Tracking
+- Method: [App / paper / calendar dot / etc.]
+- Review: [When will you look back at how it's going?]
+
+## What to do when you miss a day
+Never miss twice. One miss is an accident; two misses is a new habit.
+```

package/templates/skills/wiki/SKILL.md

@@ -0,0 +1,70 @@
+---
+name: wiki
+description: >
+  Use this skill when the user wants to build, maintain, or query a personal knowledge wiki.
+  Trigger for requests like: "ingest this article into the wiki", "add this to the wiki",
+  "what does the wiki say about X", "search the wiki for Y", "query the wiki",
+  "lint the wiki", "health check the wiki", "show me the wiki graph",
+  "summarize this paper and add it to the wiki", "file this in the wiki",
+  "update the wiki with this", "cross-reference this with the wiki",
+  "what have I read about X", "compile everything I know about Y",
+  "build a wiki page for Z", "what's in the wiki on topic W".
+  This skill wraps the Ingest, Query, and Lint workflows from WIKI.md.
+  Do NOT trigger for general note-taking, to-do lists, or session memory.
+---
+
+# Wiki Skill
+
+A skill for operating curie-agent's compounding knowledge wiki.
+The wiki is a persistent, self-maintaining markdown knowledge base.
+
+---
+
+## On Activation
+
+1. Read `~/.curie-agent/wiki/WIKI.md` (or the wiki path from settings) for the full
+   schema, page conventions, and workflow procedures.
+2. Check `~/.curie-agent/wiki/index.md` to understand what's already in the wiki.
+3. Determine which workflow applies: **Ingest**, **Query**, or **Lint**.
+
+---
+
+## Ingest
+
+Trigger: user provides a source (file, URL, text) and wants it added to the wiki.
+
+Follow the **INGEST Workflow** in WIKI.md exactly:
+- Read source → identify entities/concepts → write summary page → update related pages →
+  update index entries → append INGEST log.
+
+Slug convention: `summaries/YYYY-MM-DD-kebab-title`.
+
+---
+
+## Query
+
+Trigger: user asks a question against accumulated wiki knowledge.
+
+Follow the **QUERY Workflow** in WIKI.md:
+- Read index → search → read relevant pages → synthesize with `[[citations]]` →
+  file novel discoveries back as pages → append QUERY log.
+
+---
+
+## Lint
+
+Trigger: user asks to check wiki health, find contradictions, or clean up.
+
+Follow the **LINT Workflow** in WIKI.md:
+- `Wiki(op=lint_report)` for deterministic issues → fix broken links / missing-from-index →
+  semantic check for contradictions → append LINT log.
+
+---
+
+## Tools to Use
+
+- `Wiki` — the primary tool (all wiki operations)
+- `Read` — read local source files
+- `WebFetch` — fetch URL sources
+- `Grep`, `Glob` — supplemental file exploration
+- `Write` — only if writing outside the wiki root (avoid; prefer `Wiki(op=page_put)`)