coulomb/open-reuse
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:16 +02:00
parent 3a7a2b286d
commit 7617ca59e2
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=open-reuse
# 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. --> Managed continuity for valuable open-source integrations.
<!-- Example: "Provides a lightweight event router for Kubernetes-native systems." -->
--- ---
## Core Idea ## Core Idea
<!-- What is the main capability or idea behind this repository? --> open-reuse turns proven OSS integrations into structured, maintainable assets with clear boundaries and update loops.
<!-- What problem does it try to solve? -->
--- ---
## In Scope ## In Scope
<!-- What this repository is responsible for. --> - Integration analysis docs, registry, and workplans
<!-- Be explicit and concrete. --> - Reuse modes and continuity policies
- State Hub progress and decisions
-
-
-
--- ---
## Out of Scope ## Out of Scope
<!-- What this repository deliberately does NOT do. --> - Hosting forked upstream code long-term without policy
<!-- This is often more important than "In Scope". --> - Replacing package registries
-
-
-
---
## 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/OPEN-WP-0001-statehub-bootstrap.md
View File

@@ -4,7 +4,7 @@ type: workplan
title: "Bootstrap State Hub integration" title: "Bootstrap State Hub integration"
domain: infotech domain: infotech
repo: open-reuse repo: open-reuse
status: ready status: finished
owner: codex owner: codex
topic_slug: infotech topic_slug: infotech
created: "2026-06-22" created: "2026-06-22"
@@ -20,11 +20,14 @@ Open reuse surface tooling.
```task ```task
id: OPEN-WP-0001-T01 id: OPEN-WP-0001-T01
status: todo status: done
priority: high priority: high
state_hub_task_id: "b26b33a6-fb7e-4414-a767-e36aaf37dd80" state_hub_task_id: "b26b33a6-fb7e-4414-a767-e36aaf37dd80"
``` ```
Result 2026-06-22: Filled SCOPE.md from INTENT.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: OPEN-WP-0001-T02 id: OPEN-WP-0001-T02
status: todo status: done
priority: high priority: high
state_hub_task_id: "113135c4-8d93-4a23-a2f6-28969378a50e" state_hub_task_id: "113135c4-8d93-4a23-a2f6-28969378a50e"
``` ```
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: OPEN-WP-0001-T03 id: OPEN-WP-0001-T03
status: todo status: done
priority: medium priority: medium
state_hub_task_id: "05abbc01-8e5c-4b06-bf57-e462069b829b" state_hub_task_id: "05abbc01-8e5c-4b06-bf57-e462069b829b"
``` ```
Result 2026-06-22: Created OPEN-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/OPEN-WP-0002-integration-asset-registry.md Normal file
View File

@@ -0,0 +1,28 @@
---
id: OPEN-WP-0002
type: workplan
title: "Integration asset registry foundation"
domain: infotech
repo: open-reuse
status: ready
owner: codex
topic_slug: infotech
created: "2026-06-22"
updated: "2026-06-22"
state_hub_workstream_id: "07cec732-6526-48e4-84d0-373e4abcb6d4"
---
# Integration asset registry foundation
Establish registry format for managed OSS integration assets.
## Registry format v0.1
```task
id: OPEN-WP-0002-T01
status: todo
priority: high
state_hub_task_id: "b55b4413-2053-40bd-bee1-d138937f0b4f"
```
Define integration asset schema in `registry/` and document analyze→classify→refactor→maintain loop.