coulomb/domain-tree
2
0
Fork 0
generated from coulomb/repo-seed
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Complete State Hub bootstrap workplans (WP-0001)

Browse Source 
- Review integration files; fill SCOPE where templated
- Document dev workflow in stack-and-commands.md
- Seed WP-0002 implementation workplan; mark bootstrap finished
- Hub sync via fix-consistency
This commit is contained in:
Bernd Worsch
2026-06-22 23:35:09 +02:00
parent 682b7008c4
commit ae918e6f0a
4 changed files with 60 additions and 128 deletions
Download Patch File Download Diff File Expand all files Collapse all files

21
.claude/rules/stack-and-commands.md
View File

@@ -1,19 +1,20 @@
## Stack ## Stack
<!-- TODO: Fill in language, frameworks, and key dependencies --> - **Language:** Markdown-first registry and planning repo (no application runtime yet)
- **Language:** - **Key deps:** State Hub ADR-001 workplans, `registry/indexes/capabilities.yaml`
- **Key deps:**
## Dev Commands ## Dev Commands
```bash ```bash
# TODO: Fill in the standard commands for this repo # Orient (offline-safe)
cat .custodian-brief.md
cat INTENT.md
cat SCOPE.md
ls workplans/
# Install dependencies # After workplan or registry edits — from ~/state-hub
make fix-consistency REPO=domain-tree
# Run tests # Sanity-check markdown / registry edits
git diff --check
# Lint / type check
# Build / package (if applicable)
``` ```

122
SCOPE.md
View File

@@ -1,137 +1,31 @@
# SCOPE # SCOPE
> This file helps you quickly understand what this repository is about, > Lightweight boundary for agents and contributors.
> when it is relevant, and when it is not.
> It is intentionally lightweight and may be incomplete.
--- ---
## One-liner ## One-liner
<!-- Describe the purpose of this repository in one precise sentence. --> Domain capability tree for navigating and classifying repository domains.
<!-- Example: "Provides a lightweight event router for Kubernetes-native systems." -->
--- ---
## Core Idea ## Core Idea
<!-- What is the main capability or idea behind this repository? --> domain-tree maintains the hierarchical view of domains, topics, and capability relationships.
<!-- What problem does it try to solve? -->
--- ---
## In Scope ## In Scope
<!-- What this repository is responsible for. --> - Domain tree registry indexes and documentation
<!-- Be explicit and concrete. --> - Alignment with State Hub domain/topic model
- Workplans for tree evolution
-
-
-
--- ---
## Out of Scope ## Out of Scope
<!-- What this repository deliberately does NOT do. --> - Owning individual domain implementations
<!-- This is often more important than "In Scope". --> - Replacing State Hub domain administration
-
-
-
---
## Relevant When
<!-- When should someone consider using or exploring this repository? -->
-
-
-
---
## Not Relevant When
<!-- When should someone ignore this repository? -->
-
-
-
---
## Current State
<!-- Rough indication of maturity. No strict format required. -->
- Status: <!-- e.g. concept / experimental / active / stable / deprecated -->
- Implementation: <!-- e.g. idea / partial / substantial / complete -->
- Stability: <!-- e.g. unstable / evolving / stable -->
- Usage: <!-- e.g. none / personal / internal / production -->
<!-- Add any notes that help set expectations. -->
---
## How It Fits
<!-- Where does this repository sit in the bigger picture? -->
- Upstream dependencies:
- Downstream consumers:
- Often used with:
---
## Terminology
<!-- Terms that are important to understand this repo. -->
<!-- Especially useful if naming differs from other repos. -->
- Preferred terms:
- Also known as:
- Potentially confusing terms:
---
## Related / Overlapping Repositories
<!-- List repositories that have similar or adjacent responsibilities. -->
<!-- Helps detect duplication and navigate the ecosystem. -->
- <repo-name> — <!-- how it relates -->
---
## Getting Oriented
<!-- If someone decides to look deeper, where should they start? -->
- Start with:
- Key files / directories:
- Entry points:
---
## Provided Capabilities
<!-- What can this repo's domain provide to other domains on request? -->
<!-- Each capability block is parsed by the state-hub capability catalog ingest. -->
<!-- Remove the examples and add your own, or leave empty if none. -->
<!--
```capability
type: infrastructure
title: Example capability title
description: What this capability provides, in one or two sentences.
keywords: [keyword1, keyword2, keyword3]
```
-->
---
## Notes
<!-- Anything else worth knowing. Keep it short. -->

17
workplans/DOMAIN-WP-0001-statehub-bootstrap.md
View File

@@ -4,7 +4,7 @@ type: workplan
title: "Bootstrap State Hub integration" title: "Bootstrap State Hub integration"
domain: communication domain: communication
repo: domain-tree repo: domain-tree
status: ready status: finished
owner: codex owner: codex
topic_slug: communication topic_slug: communication
created: "2026-06-22" created: "2026-06-22"
@@ -20,11 +20,14 @@ Domain tree modeling utilities.
```task ```task
id: DOMAIN-WP-0001-T01 id: DOMAIN-WP-0001-T01
status: todo status: done
priority: high priority: high
state_hub_task_id: "c0ef631e-b178-4e77-a8fd-41c8e810f6fe" state_hub_task_id: "c0ef631e-b178-4e77-a8fd-41c8e810f6fe"
``` ```
Result 2026-06-22: Filled SCOPE.md.
Review `INTENT.md`, `SCOPE.md`, `AGENTS.md`, and `.custodian-brief.md`. Review `INTENT.md`, `SCOPE.md`, `AGENTS.md`, and `.custodian-brief.md`.
Replace generated placeholders with repo-specific facts where needed. Replace generated placeholders with repo-specific facts where needed.
@@ -32,11 +35,14 @@ Replace generated placeholders with repo-specific facts where needed.
```task ```task
id: DOMAIN-WP-0001-T02 id: DOMAIN-WP-0001-T02
status: todo status: done
priority: high priority: high
state_hub_task_id: "d975ca87-7e29-4a5f-8761-e5151ce2cdd4" state_hub_task_id: "d975ca87-7e29-4a5f-8761-e5151ce2cdd4"
``` ```
Result 2026-06-22: Registry workflow documented.
Identify the repo's install, test, lint, build, and run commands. Add or refine Identify the repo's install, test, lint, build, and run commands. Add or refine
those commands in the agent instructions so future coding sessions can verify those commands in the agent instructions so future coding sessions can verify
changes confidently. changes confidently.
@@ -45,11 +51,14 @@ changes confidently.
```task ```task
id: DOMAIN-WP-0001-T03 id: DOMAIN-WP-0001-T03
status: todo status: done
priority: medium priority: medium
state_hub_task_id: "3b9ed480-4009-4ad3-a1d9-38785561fb15" state_hub_task_id: "3b9ed480-4009-4ad3-a1d9-38785561fb15"
``` ```
Result 2026-06-22: Created DOMAIN-WP-0002.
Create the first implementation workplan for the repository's most important Create the first implementation workplan for the repository's most important
next change. After workplan file updates, run from `~/state-hub`: next change. After workplan file updates, run from `~/state-hub`:

28
workplans/DOMAIN-WP-0002-domain-tree-index-foundation.md Normal file
View File

@@ -0,0 +1,28 @@
---
id: DOMAIN-WP-0002
type: workplan
title: "Domain tree index foundation"
domain: communication
repo: domain-tree
status: ready
owner: codex
topic_slug: communication
created: "2026-06-22"
updated: "2026-06-22"
state_hub_workstream_id: "88a10886-137d-475b-a446-9c34deee9a08"
---
# Domain tree index foundation
Populate the initial domain tree registry index linked to State Hub topics.
## Seed domain tree index
```task
id: DOMAIN-WP-0002-T01
status: todo
priority: high
state_hub_task_id: "5008cd75-48d4-4435-a472-eac99bae84bb"
```
Define `registry/indexes/domain-tree.yaml` structure and seed entries for active infotech domains.