diff --git a/README.md b/README.md index 9545e21..105ba9e 100644 --- a/README.md +++ b/README.md @@ -188,6 +188,8 @@ Nodes are **doors**, not “load every submodule into context.” ## Optional profiles (not Core L0) +Incubator maturity table (status / based on / used by): [`cookbook/README.md`](./cookbook/README.md). + After map-only helps, you **may** add local procedure files (often gitignored): ```mermaid diff --git a/cookbook/README.md b/cookbook/README.md new file mode 100644 index 0000000..8ebbb7b --- /dev/null +++ b/cookbook/README.md @@ -0,0 +1,20 @@ +# Cookbook profiles — status incubator + +Optional profiles and patterns. **Not Core L0.** Status is author-maintained maturity signal only. + +Allowed status values: `used in practice` · `tried once` · `idea only` · empty (pending author) + +| Profile | Status | Based on | Used by | +|---------|--------|----------|---------| +| [schema-pinning](./schema-pinning.md) | used in practice | pin / immutable tag practice | author only | +| [local-bootstrap](./local-bootstrap.md) | used in practice | thin orientation + local index | author only | +| [done-bar](./done-bar.md) | used in practice | accept before done / PR | author only | +| [glass-box-factory](./glass-box-factory.md) | tried once | recent early trial | author only | +| [orchestrator-session](./orchestrator-session.md) | tried once | recent early trial | author only | +| [stream-packs](./stream-packs.md) | — | one task-class pack per session | — | +| [hub-umbrella](./hub-umbrella.md) | — | multi-repo shell map hops | — | +| [brownfield-init](./brownfield-init.md) | — | add map to an existing repo | — | + +`what-not-to-copy` is guidance, not a profile — omitted from this table. + +See also: [root README — optional profiles](../README.md#optional-profiles-not-core-l0). diff --git a/cookbook/brownfield-init.md b/cookbook/brownfield-init.md index 0a83d53..b97d03e 100644 --- a/cookbook/brownfield-init.md +++ b/cookbook/brownfield-init.md @@ -1,5 +1,7 @@ # Cookbook: brownfield init +> **Profile status:** pending author + ## Goal Add AAP orientation to an existing repo **without** rewriting its docs system. diff --git a/cookbook/done-bar.md b/cookbook/done-bar.md index 1e42e17..6287a6f 100644 --- a/cookbook/done-bar.md +++ b/cookbook/done-bar.md @@ -1,5 +1,7 @@ # Cookbook: done bar (optional profile) +> **Profile status:** used in practice + > **Optional profile — not required for Orientation conformance.** > Core L0 remains: discoverable map only. diff --git a/cookbook/glass-box-factory.md b/cookbook/glass-box-factory.md index 802419e..ef98cc0 100644 --- a/cookbook/glass-box-factory.md +++ b/cookbook/glass-box-factory.md @@ -1,5 +1,7 @@ # Cookbook: glass-box factory (optional pattern) +> **Profile status:** tried once + > **Optional pattern — not required for Orientation conformance.** > Documents a *shape* for visible multi-session work. **No CLI or harness ships in this Core repo.** diff --git a/cookbook/hub-umbrella.md b/cookbook/hub-umbrella.md index 431d713..bd7773e 100644 --- a/cookbook/hub-umbrella.md +++ b/cookbook/hub-umbrella.md @@ -1,5 +1,7 @@ # Cookbook: hub umbrella (multi-repo shell) +> **Profile status:** pending author + > **Teaching pattern on Core maps.** Core already allows shell maps (`nodes` + child `map.path`). This page scales the idea. Not a new Core requirement. ## Problem diff --git a/cookbook/local-bootstrap.md b/cookbook/local-bootstrap.md index 77cc80a..9f4d91e 100644 --- a/cookbook/local-bootstrap.md +++ b/cookbook/local-bootstrap.md @@ -1,5 +1,7 @@ # Cookbook: local bootstrap (optional profile) +> **Profile status:** used in practice + > **Optional profile — not required for Orientation conformance.** > Keeps machine GPS and session procedure out of the committed Core map. diff --git a/cookbook/orchestrator-session.md b/cookbook/orchestrator-session.md index 19a499f..17cc717 100644 --- a/cookbook/orchestrator-session.md +++ b/cookbook/orchestrator-session.md @@ -1,5 +1,7 @@ # Cookbook: orchestrator session (optional profile) +> **Profile status:** tried once + > **Optional profile — not required for Orientation conformance.** > Harness-agnostic **shape** for manager / worker / handoff. Multi-agent “teams” features are **one** possible implementation — not required by AAP. diff --git a/cookbook/schema-pinning.md b/cookbook/schema-pinning.md index 37fdf67..03089d9 100644 --- a/cookbook/schema-pinning.md +++ b/cookbook/schema-pinning.md @@ -1,5 +1,7 @@ # Cookbook: schema pinning +> **Profile status:** used in practice + > **Consumer ops guidance — not a new Core schema feature.** > Keeps validators honest when upstream evolves. diff --git a/cookbook/stream-packs.md b/cookbook/stream-packs.md index 40bbfac..07c6e07 100644 --- a/cookbook/stream-packs.md +++ b/cookbook/stream-packs.md @@ -1,5 +1,7 @@ # Cookbook: stream packs (optional profile) +> **Profile status:** pending author + > **Optional profile — not required for Orientation conformance.** > Core L0 remains: discoverable map only.