Compare commits
2 Commits
issue-38-c
...
issue-40-m
| Author | SHA1 | Date | |
|---|---|---|---|
|
a8a35575b5
|
|||
|
fdf8a61077
|
71
commands/manifesto.md
Normal file
71
commands/manifesto.md
Normal file
@@ -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
|
||||||
88
learnings/README.md
Normal file
88
learnings/README.md
Normal file
@@ -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`
|
||||||
Reference in New Issue
Block a user