From 1dff2754794679282529e9d6c270327ee605308c Mon Sep 17 00:00:00 2001 From: Hugo Nijhuis Date: Wed, 7 Jan 2026 22:21:31 +0100 Subject: [PATCH] Use sibling repo convention for manifesto location MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 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 --- commands/vision.md | 23 +++++++++++++++++++++-- skills/vision-management/SKILL.md | 6 +++--- 2 files changed, 24 insertions(+), 5 deletions(-) diff --git a/commands/vision.md b/commands/vision.md index e8784a3..e528430 100644 --- a/commands/vision.md +++ b/commands/vision.md @@ -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. +## 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 -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 jobs to be done (What They're Trying to Achieve) - Extract guiding principles - 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 @@ -95,7 +114,7 @@ Success: " ```markdown # 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 diff --git a/skills/vision-management/SKILL.md b/skills/vision-management/SKILL.md index 7f8a8ea..bf9fe1e 100644 --- a/skills/vision-management/SKILL.md +++ b/skills/vision-management/SKILL.md @@ -11,8 +11,8 @@ How to create, maintain, and evolve organizational direction at two levels: mani | Level | Document | Purpose | Command | Location | |-------|----------|---------|---------|----------| -| **Organization** | `manifesto.md` | Identity, shared personas, beliefs, principles | `/manifesto` | Architecture repo | -| **Product** | `vision.md` | Product-specific personas, jobs, solution | `/vision` | Product repos | +| **Organization** | `manifesto.md` | Identity, shared personas, beliefs, principles | `/manifesto` | `../architecture/` (sibling repo) | +| **Product** | `vision.md` | Product-specific personas, jobs, solution | `/vision` | Product repo root | | **Goals** | Gitea milestones | Measurable progress toward vision | `/vision goals` | Per repo | 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 # 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