flowmade-one/architecture
3
0
Fork 0
Code Issues 15 Pull Requests 1 Actions Packages Projects Releases Wiki Activity

Use sibling repo convention for manifesto location

Browse Source 
Product repos find the manifesto at ../architecture/manifesto.md.
This allows the architecture repo to be a sibling of product repos.

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

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
Hugo Nijhuis
2026-01-07 22:21:31 +01:00
parent c88304a271
commit 1dff275479
2 changed files with 24 additions and 5 deletions
Download Patch File Download Diff File Expand all files Collapse all files

23
commands/vision.md
View File

@@ -20,13 +20,32 @@ This command manages **product-level** vision. For organization-level vision, us
Product vision **inherits from and extends** the organization manifesto - it should never duplicate. Product vision **inherits from and extends** the organization manifesto - it should never duplicate.
## Manifesto Location
The manifesto lives in the sibling `architecture` repo:
```
org/
├── architecture/
│ └── manifesto.md ← organization manifesto
├── product-a/
│ └── vision.md ← extends ../architecture/manifesto.md
└── product-b/
└── vision.md
```
Look for manifesto in this order:
1. `./manifesto.md` (if this IS the architecture repo)
2. `../architecture/manifesto.md` (sibling repo)
## Process ## Process
1. **Load organization context**: Read `manifesto.md` from the architecture repo (`~/.claude/manifesto.md` or repo root) 1. **Load organization context**: Find and read `manifesto.md` using the location rules above
- Extract personas (Who We Serve) - Extract personas (Who We Serve)
- Extract jobs to be done (What They're Trying to Achieve) - Extract jobs to be done (What They're Trying to Achieve)
- Extract guiding principles - Extract guiding principles
- Extract non-goals - Extract non-goals
- If not found, warn and continue without inheritance context
2. **Check for product vision**: Look for `vision.md` in the current repo root 2. **Check for product vision**: Look for `vision.md` in the current repo root
@@ -95,7 +114,7 @@ Success: <criteria>"
```markdown ```markdown
# Vision # Vision
This product vision builds on the [organization manifesto](link-to-manifesto). This product vision builds on the [organization manifesto](../architecture/manifesto.md).
## Who This Product Serves ## Who This Product Serves

6
skills/vision-management/SKILL.md
View File

@@ -11,8 +11,8 @@ How to create, maintain, and evolve organizational direction at two levels: mani
| Level | Document | Purpose | Command | Location | | Level | Document | Purpose | Command | Location |
|-------|----------|---------|---------|----------| |-------|----------|---------|---------|----------|
| **Organization** | `manifesto.md` | Identity, shared personas, beliefs, principles | `/manifesto` | Architecture repo | | **Organization** | `manifesto.md` | Identity, shared personas, beliefs, principles | `/manifesto` | `../architecture/` (sibling repo) |
| **Product** | `vision.md` | Product-specific personas, jobs, solution | `/vision` | Product repos | | **Product** | `vision.md` | Product-specific personas, jobs, solution | `/vision` | Product repo root |
| **Goals** | Gitea milestones | Measurable progress toward vision | `/vision goals` | Per repo | | **Goals** | Gitea milestones | Measurable progress toward vision | `/vision goals` | Per repo |
Product vision **inherits from and extends** the organization manifesto - it should never duplicate. Product vision **inherits from and extends** the organization manifesto - it should never duplicate.
@@ -81,7 +81,7 @@ The vision defines what a specific product does. It lives in each product repo a
```markdown ```markdown
# Vision # Vision
This product vision builds on the [organization manifesto](link-to-manifesto). This product vision builds on the [organization manifesto](../architecture/manifesto.md).
## Who This Product Serves ## Who This Product Serves