generated from coulomb/repo-seed
feat(bootstrap): complete ATLAS-WP-0001 State Hub integration
Customize config-atlas identity (INTENT, SCOPE, AGENTS, rules), document dev workflow commands, remove inherited repo-seed workplans, and add ATLAS-WP-0002 registry foundation workplan.
This commit is contained in:
47
SCOPE.md
47
SCOPE.md
@@ -6,26 +6,59 @@
|
||||
|
||||
## One-liner
|
||||
|
||||
Git repository template to bootstrap coulomb projects.
|
||||
Federated configuration atlas — cataloging configuration surfaces, schemas,
|
||||
defaults, ownership, and cross-repo relationships across the Coulomb ecosystem.
|
||||
|
||||
---
|
||||
|
||||
## Core Idea
|
||||
|
||||
repo-seed is the canonical template for new repos: agent instructions, registry scaffold, and onboarding conventions.
|
||||
`config-atlas` indexes **configuration surfaces**: bounded, named places where
|
||||
configuration is defined, read, or overridden (files, env vars, APIs, feature
|
||||
flags, policy bundles, deployment parameters). Each surface gets a registry entry
|
||||
with ownership, scope, validation hooks, and links to canonical sources.
|
||||
|
||||
The atlas helps agents and operators answer:
|
||||
|
||||
1. What configuration exists for a repo, capability, or deployment context?
|
||||
2. Who owns it and where is the source of truth?
|
||||
3. What are the safe defaults and precedence rules?
|
||||
4. Which other surfaces depend on or override it?
|
||||
|
||||
---
|
||||
|
||||
## In Scope
|
||||
|
||||
- Template files for new repo bootstrap
|
||||
- Documentation for statehub_register usage
|
||||
- Registry capability entry for template capability
|
||||
- Configuration surface registry (`registry/`) with indexes and capability entries
|
||||
- Schema and naming conventions for atlas entries
|
||||
- Cross-repo relationship documentation (consumes, overrides, extends)
|
||||
- Contribution and validation workflow docs
|
||||
- State Hub workplans and agent orientation files
|
||||
|
||||
---
|
||||
|
||||
## Out of Scope
|
||||
|
||||
- Application runtime code
|
||||
- Owning downstream project implementations
|
||||
- Secret values, credentials, or environment-specific live config
|
||||
- Application runtime, deployment automation, or config push/pull engines
|
||||
- Owning downstream repo implementations or their local config files
|
||||
- Template bootstrap mechanics (`repo-seed` and `statehub register`)
|
||||
|
||||
---
|
||||
|
||||
## Current State
|
||||
|
||||
- State Hub integration bootstrapped (ATLAS-WP-0001).
|
||||
- Inherited `repo-seed` registry and template docs pending replacement
|
||||
(ATLAS-WP-0002).
|
||||
- No application runtime; markdown-first registry and planning repo.
|
||||
|
||||
---
|
||||
|
||||
## Getting Oriented
|
||||
|
||||
- Start with: `INTENT.md`
|
||||
- Agent instructions: `AGENTS.md`
|
||||
- Workplans: `workplans/`
|
||||
- Verify: `cat .custodian-brief.md` ; `ls workplans/` ; from `~/state-hub`:
|
||||
`make fix-consistency REPO=config-atlas`
|
||||
Reference in New Issue
Block a user