Skip to content

Commit f1ec84e

Browse files
KooshaPariKooshaPari
authored
docs(genesis): Wave 5 fleet governance rollout (#111)
1 parent 255a21c commit f1ec84e

10 files changed

Lines changed: 158 additions & 0 deletions

File tree

‎SOTA.md‎

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,11 @@
1+
# SOTA — phenotype-journeys
2+
3+
Single-repo SOTA index. Dimension docs under `docs/sota/`.
4+
5+
| Dimension | Path |
6+
|-----------|------|
7+
| Technical | [technical.md](docs/sota/technical.md) |
8+
9+
## Summary
10+
11+
Rust Tier 1 test orchestration; Py packages remain Tier 2 edges.

‎charter.md‎

Lines changed: 47 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,47 @@
1+
# Charter — phenotype-journeys
2+
3+
> **Boundary class:** sdk-domain
4+
> **Role:** test
5+
> **Lifecycle:** active
6+
> **Genesis template:** HexaKit `templates/genesis/` v1.0.0
7+
8+
## Mission
9+
10+
E2E journey harness and Rust CLI for the test role.
11+
12+
## Scope
13+
14+
### In scope
15+
16+
- Journey definitions, fixtures, CLI runner
17+
- Integration with phenotype-python-sdk testing packages
18+
19+
### Out of scope
20+
21+
| Boundary | Owner repo |
22+
|----------|------------|
23+
| Unit test libraries | `phenotype-python-sdk testing-kit` |
24+
| Static analysis | `KodeVibe` |
25+
26+
## Governance artifacts
27+
28+
| Artifact | Path |
29+
|----------|------|
30+
| Intent | [intent.md](intent.md) |
31+
| Review | [review.md](review.md) |
32+
| SOTA | [SOTA.md](SOTA.md) |
33+
| OKF | [okf/manifest.okf.yaml](okf/manifest.okf.yaml) |
34+
35+
Authority: [phenotype-registry DOMAIN_ROLES](https://github.com/KooshaPari/phenotype-registry/blob/main/DOMAIN_ROLES.md)
36+
37+
## Decision rights
38+
39+
| Action | Authority |
40+
|--------|-----------|
41+
| Merge to `main` | KooshaPari + 1 reviewer |
42+
43+
## Changelog
44+
45+
| Date | Change |
46+
|------|--------|
47+
| 2026-06-17 | Genesis rollout Wave 5 |

‎docs/intent/README.md‎

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,7 @@
1+
# Intent prompts
2+
3+
Scrape session prompts into `docs/intent/prompts/` per HexaKit genesis standard.
4+
5+
```bash
6+
python ../HexaKit/scripts/extract-intent-prompts.py --out-dir docs/intent/prompts --repo phenotype-journeys
7+
```

‎docs/intent/assumptions.md‎

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,6 @@
1+
# Assumptions — phenotype-journeys
2+
3+
| Assumption | Validation |
4+
|------------|------------|
5+
| Role `test` is canonical for this repo | DOMAIN_ROLES.md |
6+
| Genesis lowercase filenames are fleet standard | HexaKit STANDARD.md |

‎docs/intent/prompts/.gitkeep‎

Whitespace-only changes.

‎docs/intent/synthesis.md‎

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,11 @@
1+
# Intent synthesis — phenotype-journeys
2+
3+
## Confirmed
4+
5+
1. Own `test` role per DOMAIN_ROLES.md
6+
2. Genesis bootstrap from HexaKit templates/genesis/
7+
3. Rust Tier 1 test orchestration; Py packages remain Tier 2 edges.
8+
9+
## Deferred
10+
11+
- Full intent prompt scrape (run extract-intent-prompts.py)

‎docs/sota/technical.md‎

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,13 @@
1+
# SOTA — Technical / language placement
2+
3+
**Role:** `test`
4+
**Owner:** `phenotype-journeys`
5+
6+
## Placement
7+
8+
Rust Tier 1 test orchestration; Py packages remain Tier 2 edges.
9+
10+
## References
11+
12+
- [DOMAIN_ROLES.md](https://github.com/KooshaPari/phenotype-registry/blob/main/DOMAIN_ROLES.md)
13+
- [LANGUAGE_PLACEMENT.md](https://github.com/KooshaPari/phenotype-registry/blob/main/LANGUAGE_PLACEMENT.md)

‎intent.md‎

Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,19 @@
1+
# Intent — phenotype-journeys
2+
3+
## Problem statement
4+
5+
Fleet rationalization requires explicit role boundaries and genesis governance so agents route domain work to canonical owners.
6+
7+
## Success criteria
8+
9+
- [ ] Genesis doc set linked (charter, review, intent, SOTA, OKF)
10+
- [ ] Language placement documented in `docs/sota/technical.md`
11+
- [ ] Role `test` aligned with phenotype-registry
12+
13+
## Non-goals
14+
15+
See [charter.md](charter.md#out-of-scope).
16+
17+
## Synthesized goals
18+
19+
[docs/intent/synthesis.md](docs/intent/synthesis.md)

‎okf/manifest.okf.yaml‎

Lines changed: 23 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,23 @@
1+
okf_version: "1.0"
2+
project:
3+
id: koosha.phenotype.phenotype-journeys
4+
name: phenotype-journeys
5+
charter_ref: charter.md
6+
review_ref: review.md
7+
artifacts:
8+
- id: charter
9+
path: charter.md
10+
kind: governance
11+
summary: "test role boundary"
12+
- id: intent-root
13+
path: intent.md
14+
kind: intent
15+
summary: "Wave 4 genesis rollout"
16+
- id: sota-root
17+
path: SOTA.md
18+
kind: sota
19+
summary: "Rust Tier 1 test orchestration; Py packages remain Tier 2 edges."
20+
dimensions:
21+
technical: docs/sota/technical.md
22+
provenance:
23+
intent_prompts: docs/intent/prompts/

‎review.md‎

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,21 @@
1+
# review.md — Kilo Code Stand
2+
3+
## Kilo Code Stand
4+
5+
- **standard_id:** `kilo-code-stand@1`
6+
- **applies_to:** all PRs; agent-authored commits
7+
- **owner:** KooshaPari
8+
- **charter:** [charter.md](charter.md)
9+
- **sota:** [SOTA.md](SOTA.md)
10+
11+
## Review tiers
12+
13+
| Tier | Action | Rules |
14+
|------|--------|-------|
15+
| **Block** | Fail PR | Secrets; scope outside charter; domain logic in wrong role owner |
16+
| **Warn** | Comment | Doc drift from SOTA; incomplete OKF update |
17+
| **Info** | Optional | Style |
18+
19+
## Agent autonomy
20+
21+
Level **2** — agents may open PRs; human or CI merge required.

0 commit comments

Comments
 (0)