Create /manifesto command for organization vision

Adds new command to view and manage the organization-level manifesto.
Distinct from /vision which handles product-level vision.

Features:
- Guides manifesto creation if none exists
- Displays formatted summary of existing manifesto
- References vision-management skill
- Clear output format for all sections

Closes #40

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

commands/create-issue.md

@@ -28,13 +28,16 @@ If title provided:
 1. Create an issue with that title
 2. Ask for description
 3. Assign to appropriate milestone (see above)
+4. Ask if this issue depends on any existing issues
+5. If dependencies exist, link them: `tea issues deps add <new-issue> <blocker>`
 
 ## Batch Mode
 
 If $1 is "batch":
 1. Ask user for the plan/direction
 2. Fetch available milestones
-3. Generate list of issues with titles, descriptions, and milestone assignments
+3. Generate list of issues with titles, descriptions, milestone assignments, and dependencies
 4. Show for approval
-5. Create each issue with milestone
-6. Display all created issue numbers
+5. Create each issue with milestone (in dependency order)
+6. Link dependencies between created issues: `tea issues deps add <issue> <blocker>`
+7. Display all created issue numbers with dependency graph

commands/groom.md

@@ -11,23 +11,27 @@ argument-hint: [issue-number]
 
 ## If issue number provided ($1):
 
-1. **Fetch the issue** details
-2. **Evaluate** against grooming checklist
-3. **Suggest improvements** for:
+1. **Fetch the issue** details with `tea issues <number> --comments`
+2. **Check dependencies** with `tea issues deps list <number>`
+3. **Evaluate** against grooming checklist
+4. **Suggest improvements** for:
    - Title clarity
    - Description completeness
    - Acceptance criteria quality
    - Scope definition
-4. **Ask user** if they want to apply changes
-5. **Update issue** if approved
+   - Missing or incorrect dependencies
+5. **Ask user** if they want to apply changes
+6. **Update issue** if approved
+7. **Link/unlink dependencies** if needed: `tea issues deps add/remove <issue> <dep>`
 
 ## If no argument (groom all):
 
 1. **List open issues**
-2. **Review each** against grooming checklist
+2. **Review each** against grooming checklist (including dependencies)
 3. **Categorize**:
-   - Ready: Well-defined, can start work
-   - Needs work: Missing info or unclear
+   - Ready: Well-defined, dependencies linked, can start work
+   - Blocked: Has unresolved dependencies
+   - Needs work: Missing info, unclear, or missing dependency links
    - Stale: No longer relevant
-4. **Present summary** table
-5. **Offer to improve** issues that need work
+4. **Present summary** table with dependency status
+5. **Offer to improve** issues that need work (including linking dependencies)

commands/manifesto.md

@@ -0,0 +1,71 @@
+---
+description: View and manage the organization manifesto. Shows identity, personas, beliefs, and principles.
+---
+
+# Organization Manifesto
+
+@~/.claude/skills/vision-management/SKILL.md
+
+The manifesto defines the organization-level vision: who we are, who we serve, what we believe, and how we work. It is distinct from product-level vision (see `/vision`).
+
+## Process
+
+1. **Check for manifesto**: Look for `manifesto.md` in the current repo root.
+
+2. **If no manifesto exists**:
+   - Ask if the user wants to create one
+   - Guide through defining:
+     1. **Who We Are**: Organization identity
+     2. **Who We Serve**: 2-4 specific personas with context and constraints
+     3. **What They're Trying to Achieve**: Jobs to be done in their voice
+     4. **What We Believe**: Core beliefs including stance on AI-augmented development
+     5. **Guiding Principles**: Decision-making rules
+     6. **Non-Goals**: What we explicitly don't do
+   - Create `manifesto.md`
+
+3. **If manifesto exists**:
+   - Display formatted summary of the manifesto
+
+## Output Format
+
+When displaying an existing manifesto:
+
+```
+## Who We Are
+
+[Identity summary from manifesto]
+
+## Who We Serve
+
+- **[Persona 1]**: [Brief description]
+- **[Persona 2]**: [Brief description]
+- **[Persona 3]**: [Brief description]
+
+## What They're Trying to Achieve
+
+- "[Job to be done 1]"
+- "[Job to be done 2]"
+- "[Job to be done 3]"
+
+## What We Believe
+
+[Summary of key beliefs - especially AI-augmented development stance]
+
+## Guiding Principles
+
+1. [Principle 1]
+2. [Principle 2]
+3. [Principle 3]
+
+## Non-Goals
+
+- [Non-goal 1]
+- [Non-goal 2]
+```
+
+## Guidelines
+
+- The manifesto is the **organization-level** document - it applies across all products
+- Update rarely - this is foundational identity, not tactical direction
+- Product repos reference the manifesto but have their own `vision.md`
+- Use `/vision` for product-level vision management

commands/plan-issues.md

@@ -10,39 +10,41 @@ argument-hint: <feature-description>
 @~/.claude/skills/issue-writing/SKILL.md
 @~/.claude/skills/vision-management/SKILL.md
 
-1. **Check vision context**: If `vision.md` exists, read it to understand current goals and focus
-2. **Understand the feature**: Analyze what "$1" involves
-3. **Explore the codebase** if needed to understand context
-4. **Break down** into discrete, actionable issues:
+1. **Check vision context**: If `vision.md` exists, read it to understand personas, jobs to be done, and goals
+2. **Identify persona**: Which persona does "$1" serve?
+3. **Identify job**: Which job to be done does this enable?
+4. **Understand the feature**: Analyze what "$1" involves
+5. **Explore the codebase** if needed to understand context
+6. **Break down** into discrete, actionable issues:
    - Each issue should be independently completable
    - Clear dependencies between issues
    - Appropriate scope (not too big, not too small)
 
-5. **Present the plan** (include vision alignment if vision exists):
+7. **Present the plan** (include vision alignment if vision exists):
    ```
    ## Proposed Issues for: $1
 
-   Vision Alignment: Supports [Goal N: description]
+   For: [Persona name]
+   Job: "[Job to be done this enables]"
+   Supports: [Milestone/Goal name]
 
    1. [Title] - Brief description
       Dependencies: none
-      Supports: Goal N
 
    2. [Title] - Brief description
       Dependencies: #1
-      Supports: Goal N
 
    3. [Title] - Brief description
       Dependencies: #1, #2
-      Supports: Goal N
    ```
 
-   If the feature doesn't align with any vision goal, note this and ask if:
-   - The vision should be updated to include this as a goal
+   If the feature doesn't align with any persona/job/goal, note this and ask if:
+   - A new persona or job should be added to the vision
+   - A new milestone should be created
    - This should be added as a non-goal
    - Proceed anyway (with justification)
 
-6. **Ask for approval** before creating issues
-7. **Create issues** in order
-8. **Update dependencies** with actual issue numbers after creation
-9. **Present summary** with links to created issues
+8. **Ask for approval** before creating issues
+9. **Create issues** in dependency order (blockers first)
+10. **Link dependencies** using `tea issues deps add <issue> <blocker>` for each dependency
+11. **Present summary** with links to created issues and dependency graph

commands/vision.md

@@ -25,9 +25,15 @@ Issues are assigned to milestones. Progress is visible through milestone complet
 
 2. **If no vision exists**:
    - Ask the user if they want to create one
-   - Guide them through the philosophy: purpose, principles, non-goals
+   - Guide them through defining:
+     1. **Personas**: Who are we building for? (2-4 specific personas)
+     2. **Jobs to be done**: What are they trying to achieve?
+     3. **The problem**: What pain points exist today?
+     4. **The solution**: How does this product address their jobs?
+     5. **Guiding principles**: What beliefs guide decisions?
+     6. **Non-goals**: What are we explicitly NOT doing?
    - Create `vision.md` (do NOT include goals/progress - that's milestones)
-   - Ask about initial goals and create them as Gitea milestones
+   - Ask about initial goals tied to personas/jobs, create as Gitea milestones
 
 3. **If vision exists**:
    - Display the vision philosophy from `vision.md`
@@ -54,15 +60,25 @@ Issues are assigned to milestones. Progress is visible through milestone complet
 ## Output Format
 
 ```
+## Who We Serve
+
+- **[Persona 1]**: [Brief description]
+- **[Persona 2]**: [Brief description]
+
+## What They're Trying to Achieve
+
+- "[Job to be done 1]"
+- "[Job to be done 2]"
+
 ## Vision
 
-[Summary of vision.md purpose/principles]
+[Summary of problem/solution from vision.md]
 
 ## Goals (Milestones)
 
-| Goal | Progress | Due |
-|------|----------|-----|
-| [title] | 3/5 issues | [date] |
+| Goal | For | Progress | Due |
+|------|-----|----------|-----|
+| [title] | [Persona] | 3/5 issues | [date] |
 
 ## Current Focus
 
@@ -71,8 +87,10 @@ Issues are assigned to milestones. Progress is visible through milestone complet
 
 ## Guidelines
 
-- vision.md is the stable "why" document - update rarely
-- Milestones are the actionable goals - create/close as needed
+- vision.md is the stable "why" and "who" document - update rarely
+- Personas and jobs to be done are foundational - everything traces back to them
+- Milestones are actionable goals - each should serve a specific persona's job
 - Assign issues to milestones to track progress
-- Use milestone descriptions for success criteria
+- Use milestone descriptions for: persona, job, success criteria
 - Due dates on milestones are optional but help prioritization
+- If you can't tie work to a persona/job, question whether it should be done

learnings/README.md

@@ -0,0 +1,88 @@
+# Learnings
+
+This folder captures learnings from retrospectives and day-to-day work. Learnings serve three purposes:
+
+1. **Historical record**: What we learned and when
+2. **Governance reference**: Why we work the way we do
+3. **Encoding source**: Input that gets encoded into skills, commands, and agents
+
+## The Learning Flow
+
+```
+Experience → Learning captured → Encoded into system → Knowledge is actionable
+                   ↓
+            Stays here for:
+            - Historical reference
+            - Governance validation
+            - Periodic review
+```
+
+Learnings are **not** the final destination. They are inputs that get encoded into commands, skills, and agents where Claude can actually use them. But we keep the learning file as a record of *why* we encoded what we did.
+
+## Writing a Learning
+
+Create a new file: `YYYY-MM-DD-short-title.md`
+
+Use this template:
+
+```markdown
+# [Title]
+
+**Date**: YYYY-MM-DD
+**Context**: What triggered this learning (task, incident, observation)
+
+## Learning
+
+The insight we gained. Be specific and actionable.
+
+## Encoded In
+
+Where this learning has been (or will be) encoded:
+
+- `skills/xxx/SKILL.md` - What was added/changed
+- `commands/xxx.md` - What was added/changed
+- `agents/xxx/agent.md` - What was added/changed
+
+If not yet encoded, note: "Pending: Issue #XX"
+
+## Governance
+
+What this learning means for how we work going forward. This is the "why" that justifies the encoding.
+```
+
+## Encoding Process
+
+1. **Capture the learning** in this folder
+2. **Create an issue** to encode it into the appropriate location
+3. **Update the skill/command/agent** with the encoded knowledge
+4. **Update the learning file** with the "Encoded In" references
+
+The goal: Claude should be able to *use* the learning, not just *read* about it.
+
+## What Gets Encoded Where
+
+| Learning Type | Encode In |
+|---------------|-----------|
+| How to use a tool | `skills/` |
+| Workflow improvement | `commands/` |
+| Subtask behavior | `agents/` |
+| Organization belief | `manifesto.md` |
+| Product direction | `vision.md` (in product repo) |
+
+## Periodic Review
+
+Periodically review learnings to:
+
+- Verify encoded locations still reflect the learning
+- Check if governance is still being followed
+- Identify patterns across multiple learnings
+- Archive or update outdated learnings
+
+## Naming Convention
+
+Files follow the pattern: `YYYY-MM-DD-short-kebab-title.md`
+
+Examples:
+- `2024-01-15-always-use-comments-flag.md`
+- `2024-01-20-verify-before-cleanup.md`
+- `2024-02-01-small-prs-merge-faster.md`

manifesto.md

@@ -0,0 +1,78 @@
+# Manifesto
+
+## Who We Are
+
+We are a small, focused team of AI-native builders. We believe the future of software development is human-AI collaboration, and we're building the tools and practices to make that real.
+
+We move fast with intention. We value quality over quantity. We encode our knowledge into systems that amplify what we can accomplish.
+
+## Who We Serve
+
+### Solo Developer
+The individual shipping side projects, MVPs, or freelance work. Time is their scarcest resource. They context-switch between coding, design, ops, and everything else. They need to move fast without sacrificing quality, and they can't afford to remember every command or best practice.
+
+### Small Team (2-5 people)
+The startup or small product team that needs to punch above their weight. They don't have dedicated specialists for every function. They need consistency across contributors and visibility into what's happening without heavyweight process.
+
+### Agency / Consultancy
+Building for clients under deadlines. They need speed, consistency, and the ability to apply learnings across projects. Every efficiency gain multiplies across engagements.
+
+## What They're Trying to Achieve
+
+- "Help me ship without getting bogged down in repetitive tasks"
+- "Help me maintain quality without slowing down"
+- "Help me know what to work on next without checking multiple tools"
+- "Help me apply best practices without memorizing them"
+- "Help me onboard to codebases faster"
+- "Help me stay in flow instead of context-switching"
+
+## What We Believe
+
+### AI-Augmented Development
+
+We believe AI fundamentally changes how software is built:
+
+- **Developers become orchestrators.** The role shifts from writing every line to directing, reviewing, and refining. The human provides judgment, context, and intent. AI handles execution and recall.
+
+- **Repetitive tasks should be automated.** If you do something more than twice, encode it. Commits, PR creation, issue management, code review - these should flow, not interrupt.
+
+- **AI amplifies individuals.** A solo developer with good AI tooling can accomplish what used to require a team. Small teams can tackle problems that used to need departments.
+
+- **Knowledge belongs in systems, not heads.** Best practices, patterns, and learnings should be encoded where AI can apply them. Tribal knowledge is a liability.
+
+- **Iteration speed is a competitive advantage.** The faster you can go from idea to deployed code to learning, the faster you improve. AI collapses the feedback loop.
+
+### Quality Without Ceremony
+
+- Ship small, ship often
+- Automate verification, not just generation
+- Good defaults beat extensive configuration
+- Working software over comprehensive documentation
+
+### Sustainable Pace
+
+- Tools should reduce cognitive load, not add to it
+- Automation should free humans for judgment calls
+- The goal is flow, not burnout
+
+## Guiding Principles
+
+1. **Encode, don't document.** If something is important enough to write down, it's important enough to encode into a skill, command, or agent that can act on it.
+
+2. **Small teams, big leverage.** Design for amplification. Every tool, pattern, and practice should multiply what individuals can accomplish.
+
+3. **Opinionated defaults, escape hatches available.** Make the right thing easy. Make customization possible but not required.
+
+4. **Learn in public.** Capture learnings. Update the system. Share what works.
+
+5. **Ship to learn.** Prefer shipping something imperfect and learning from reality over planning for perfection.
+
+## Non-Goals
+
+- **Building for enterprises with complex compliance needs.** We optimize for speed and small teams, not audit trails and approval workflows.
+
+- **Supporting every tool and platform.** We go deep on our chosen stack rather than shallow on everything.
+
+- **Replacing developer judgment.** AI augments human decision-making; it doesn't replace it. Critical thinking, architecture decisions, and user empathy remain human responsibilities.
+
+- **Comprehensive documentation for its own sake.** We encode knowledge into actionable systems. Docs exist to explain the "why," not to duplicate what the system already does.

skills/backlog-grooming/SKILL.md

@@ -33,10 +33,18 @@ For each issue, verify:
 - [ ] Clear boundaries (what's included/excluded)
 
 ### 5. Dependencies
-- [ ] Dependencies identified
+- [ ] Dependencies identified in description
+- [ ] Dependencies formally linked (`tea issues deps list <number>`)
 - [ ] No circular dependencies
 - [ ] Blocking issues are tracked
 
+To check/fix dependencies:
+```bash
+tea issues deps list <number>           # View current dependencies
+tea issues deps add <issue> <blocker>   # Add missing dependency
+tea issues deps remove <issue> <dep>    # Remove incorrect dependency
+```
+
 ### 6. Labels
 - [ ] Type label (bug/feature/etc)
 - [ ] Priority if applicable

skills/gitea/SKILL.md

@@ -70,6 +70,13 @@ tea issues reopen <number>
 
 # Labels
 tea issues edit <number> --labels "bug,help wanted"
+
+# Dependencies
+tea issues deps list <number>              # List blockers for an issue
+tea issues deps add <issue> <blocker>      # Add dependency (issue is blocked by blocker)
+tea issues deps add 5 3                    # Issue #5 depends on #3
+tea issues deps add 5 owner/repo#3         # Cross-repo dependency
+tea issues deps remove <issue> <blocker>   # Remove a dependency
 ```
 
 ### Pull Requests

skills/issue-writing/SKILL.md

@@ -104,7 +104,19 @@ Use labels to categorize:
 
 ## Dependencies
 
-Reference related issues:
-- "Depends on #N" - Must complete first
-- "Blocks #N" - This blocks another
-- "Related to #N" - Informational link
+Identify and link dependencies when creating issues:
+
+1. **In the description**, document dependencies:
+   ```markdown
+   ## Dependencies
+   - Depends on #12 (must complete first)
+   - Related to #15 (informational)
+   ```
+
+2. **After creating the issue**, formally link blockers using tea CLI:
+   ```bash
+   tea issues deps add <this-issue> <blocker-issue>
+   tea issues deps add 5 3    # Issue #5 is blocked by #3
+   ```
+
+This creates a formal dependency graph that tools can query.

skills/roadmap-planning/SKILL.md

@@ -80,6 +80,13 @@ In issue descriptions:
 - Depends on #13 (API setup)
 ```
 
+After creating issues, formally link dependencies:
+```bash
+tea issues deps add <issue> <blocker>
+tea issues deps add 14 12    # Issue #14 depends on #12
+tea issues deps add 14 13    # Issue #14 depends on #13
+```
+
 ## Creating Issues
 
 Use the gitea skill for issue operations.

skills/vision-management/SKILL.md

@@ -22,39 +22,81 @@ The vision system has two layers:
 
 ## Vision Document Structure
 
-The vision.md file should contain the stable "why" - not progress tracking:
+The vision.md file should contain the stable "why" and "who" - not progress tracking:
 
 ```markdown
 # Vision
 
+## Who We Serve (Personas)
+The people we're building for and what characterizes them.
+
+- **Persona Name**: Brief description of who they are, their context, constraints
+
+## What They're Trying to Achieve (Jobs to Be Done)
+The outcomes our personas are trying to accomplish - in their words.
+
+- "Help me [achieve outcome] without [pain point]"
+- "Help me [do thing] so I can [benefit]"
+
 ## The Problem
-What problem does this product solve? Who benefits?
+Current pain points that prevent our personas from achieving their jobs.
 
 ## The Solution
-How does this product solve the problem?
+How this product addresses the jobs to be done.
 
 ## Guiding Principles
 Core beliefs that guide decisions.
 
 ## Non-Goals
-What we're explicitly NOT doing.
+What we're explicitly NOT doing (and why).
 ```
 
 Do NOT include goals, progress, or focus in vision.md - that's what milestones are for.
 
+## Defining Personas
+
+Good personas are:
+- **Specific**: Not "developers" but "solo developers shipping MVPs"
+- **Characterized**: Include constraints, context, priorities
+- **Limited**: 2-4 personas max, or you're building for everyone (no one)
+
+| Bad | Good |
+|-----|------|
+| "Users" | "Solo developer shipping side projects on evenings/weekends" |
+| "Developers" | "Small team lead coordinating 2-5 engineers" |
+| "Companies" | "Early-stage startup with no dedicated DevOps" |
+
+## Defining Jobs to Be Done
+
+Jobs should be:
+- **Outcome-focused**: What they want to achieve, not what they do
+- **In their voice**: How they'd describe it, not technical jargon
+- **Pain-aware**: Include what's hard about it today
+
+Format: "Help me [outcome] without [pain]" or "Help me [action] so I can [benefit]"
+
+| Bad | Good |
+|-----|------|
+| "Git integration" | "Help me commit and push without remembering git commands" |
+| "Issue tracking" | "Help me know what to work on next without checking 5 tools" |
+| "Code review" | "Help me catch bugs before they ship without slowing down" |
+
 ## Creating a Vision
 
 When no vision exists:
 
-1. **Identify the problem**: What pain point does this solve?
-2. **Define the solution**: How does the product address it?
-3. **Set guiding principles**: What beliefs guide decisions?
-4. **Document non-goals**: What are you explicitly NOT doing?
-5. **Create initial milestones**: 3-5 measurable goals
+1. **Define personas**: Who are we building for? (2-4 specific personas)
+2. **Identify jobs to be done**: What are they trying to achieve?
+3. **Articulate the problem**: What pain points prevent them from achieving their jobs?
+4. **Define the solution**: How does the product address these jobs?
+5. **Set guiding principles**: What beliefs guide decisions?
+6. **Document non-goals**: What are you explicitly NOT doing?
+7. **Create initial milestones**: 3-5 measurable goals tied to personas/jobs
 
 ### Good Goals (Milestones)
 
 - Specific and measurable
+- Tied to a persona and job to be done
 - Outcome-focused (not activity-focused)
 - Have clear success criteria in the description
 
@@ -64,6 +106,25 @@ When no vision exists:
 | "Better UX" | "User can complete checkout in under 60 seconds" |
 | "More features" | "Support 3 export formats (CSV, JSON, PDF)" |
 
+### Tying Milestones to Personas
+
+Each milestone should clearly serve a persona's job to be done:
+
+```
+Milestone: "Automate routine git workflows"
+For: Solo developer
+Job: "Help me commit and push without remembering git commands"
+Success: /commit, /pr commands handle 80% of git workflows
+```
+
+Include persona context in milestone descriptions:
+```bash
+tea milestones create --title "Automate routine git workflows" \
+  --description "For: Solo developer
+Job: Ship without context switching to git commands
+Success: /commit and /pr commands handle 80% of workflows"
+```
+
 ## Managing Goals with Milestones
 
 ```bash
@@ -98,18 +159,24 @@ Progress is automatically tracked through open/closed issue counts.
 
 When creating or reviewing issues:
 
-1. **Check goal alignment**: Does this issue support a milestone?
-2. **Assign to milestone**: Link the issue to the relevant goal
-3. **Prioritize by focus**: Issues in priority milestones get worked first
-4. **Flag misalignment**: Issues without a milestone need justification
+1. **Check persona alignment**: Which persona does this serve?
+2. **Check job alignment**: Which job to be done does this enable?
+3. **Check goal alignment**: Does this issue support a milestone?
+4. **Assign to milestone**: Link the issue to the relevant goal
+5. **Prioritize by focus**: Issues in priority milestones get worked first
+6. **Flag misalignment**: Issues without clear persona/milestone need justification
+
+Every issue should trace back to: "This helps [persona] achieve [job] by [outcome]."
 
 ### Identifying Gaps
 
-Compare milestones to current backlog:
+Compare vision to current work:
 
-- Which milestones have no issues?
-- Which milestones have stalled (no recent progress)?
-- Are there issues without a milestone?
+- **Underserved personas**: Which personas have few milestones/issues?
+- **Unaddressed jobs**: Which jobs to be done have no work toward them?
+- **Empty milestones**: Which milestones have no issues?
+- **Stalled milestones**: Which milestones have no recent progress?
+- **Orphan issues**: Are there issues without a milestone?
 
 ## Connecting Retros to Vision