Gabriel Radureau
7647a68cdc
Add a root AGENTS.md (ecosystem map of factory/tools/cms + agent operating rules + the persona cohort & workflow) and a new vibe/ knowledge base for LLM agents, modeled on tree-docs conventions and the factory house style. vibe/ folders (each with a README hub + contribution rules): - ADR/ optimized MADR-lite; canonical home going forward (doc/adr stays historical) - PRD/ one subfolder per PRD, mandatory STATUS.md, QA strategy for big ones - investigations/ single INV-NNN-slug.md, or stub + folder w/ notebooks - guidebooks/ tree-docs maps; lab-ecosystem guidebook of factory+tools+cms - runbooks/ [AGENT]/[HUMAN] step procedures (EN; doc/runbooks stays FR) - shareouts/ dated FR handouts (decks/mp4) Seed content (first ADR + PRD): a safe, production-like environment to rehearse risky changes and recovery without touching real prod — local-only sandbox (k3d + arm64 VMs) with a hard prod/sandbox isolation boundary. Includes INV-001 (prod blast-radius couplings), the ecosystem guidebook, and a FR shareout. Conventions enforced: no-tombstone rule, breadcrumb spine, bidirectional cross-links, theme:base mermaid (MCP-validated) + ordered-list-after-diagram. Built with a Workflow + persona cohort; 24 files, zero dead links. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
42 lines
1.5 KiB
Markdown
42 lines
1.5 KiB
Markdown
[vibe](../README.md) > [ADR](README.md) > **_template**
|
||
|
||
<!-- Copy this file to NNNN-kebab-title.md, fill in, delete this note. -->
|
||
|
||
# ADR-NNNN: Title
|
||
|
||
> **Status**: Proposed | Accepted | Superseded by ADR-NNNN
|
||
> **Date**: YYYY-MM-DD
|
||
> **Deciders**: name(s)
|
||
|
||
## Context
|
||
|
||
What forces are at play? Describe the problem, the constraints, and the situation that makes a decision necessary. State facts, not opinions. Keep it short enough that a future reader understands *why* a decision was needed without prior context.
|
||
|
||
## Decision
|
||
|
||
The decision, stated in the active voice: "We will ...". One clear choice. If the decision has sub-parts, use a short bulleted list.
|
||
|
||
## Consequences
|
||
|
||
What becomes easier or harder as a result of this decision?
|
||
|
||
- **+** A positive outcome / something now enabled.
|
||
- **−** A trade-off / cost / new constraint accepted.
|
||
- **→** A future follow-up this implies (work deferred, a door left open, a re-evaluation trigger).
|
||
|
||
## Alternatives considered
|
||
|
||
| Option | Why not |
|
||
| --- | --- |
|
||
| Alternative A | Reason it was rejected. |
|
||
| Alternative B | Reason it was rejected. |
|
||
|
||
## QA & validation
|
||
|
||
How was (or will be) this decision validated? Tests, smoke checks, manual verification, rollback plan, or the criteria that would tell us the decision was wrong.
|
||
|
||
## References
|
||
|
||
- Link to the PR that introduces this ADR (and ensure the PR links back here).
|
||
- Related ADRs, PRDs, investigations, or external docs (descriptive link text, never "here"/"this").
|