Skip to content

docs(agentic): curate role catalog and decision records #25

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
3leapsdave merged 1 commit into from
Aug 19, 2026
Merged

docs(agentic): curate role catalog and decision records #25

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
22 changes: 18 additions & 4 deletions Makefile
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@
# make check - Run all quality checks
# make fmt - Format all files

.PHONY: all help bootstrap bootstrap-force tools check test fmt lint lint-schemas lint-config build clean version
.PHONY: all help bootstrap bootstrap-force tools check test fmt lint lint-schemas lint-config lint-role-prompts lint-coverage-attestation build clean version
# lint-config added as dependency of lint - validates config/*.yaml against schemas
.PHONY: version-set version-patch version-minor version-major
.PHONY: precommit prepush deps-check
Expand Down Expand Up @@ -273,7 +273,7 @@ lint-schemas: ## Validate JSON Schema files against meta-schema
echo "[!!] goneat not found, skipping schema validation"; \
fi

lint-config: ## Validate config data files against schemas
lint-config: lint-role-prompts lint-coverage-attestation ## Validate config data files against schemas
@echo "[..] Validating config data files..."
@if command -v goneat >/dev/null 2>&1; then \
for f in config/agentic/roles/*.yaml; do \
Expand Down Expand Up @@ -301,8 +301,6 @@ lint-config: ## Validate config data files against schemas
echo " Validating $$f..."; \
goneat validate data --schema-file schemas/coverage-attestation/v0/coverage-attestation.schema.json --data "$$f" || exit 1; \
done; \
echo " Coverage-attestation negative controls (rejects fail, baseline passes)..."; \
sh scripts/test-coverage-attestation-controls.sh || exit 1; \
for f in schemas/process-run/v0/examples/process-card.example.json; do \
[ -f "$$f" ] || continue; \
echo " Validating $$f..."; \
Expand Down Expand Up @@ -352,6 +350,22 @@ lint-config: ## Validate config data files against schemas
echo "[!!] goneat not found, skipping config validation"; \
fi

lint-role-prompts: ## Run role-prompt negative controls
@if command -v goneat >/dev/null 2>&1; then \
echo " Role-prompt negative controls (rejects fail, baseline passes)..."; \
sh scripts/test-role-prompt-controls.sh; \
else \
echo "[--] goneat not found, skipping role-prompt controls"; \
fi

lint-coverage-attestation: ## Run coverage-attestation negative controls
@if command -v goneat >/dev/null 2>&1; then \
echo " Coverage-attestation negative controls (rejects fail, baseline passes)..."; \
sh scripts/test-coverage-attestation-controls.sh; \
else \
echo "[--] goneat not found, skipping coverage-attestation controls"; \
fi

build: ## Build artifacts (validation is the build for standards repo)
@echo "Building..."
@echo "[ok] Build complete (crucible is docs - validation is the build)"
Expand Down
39 changes: 23 additions & 16 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -68,7 +68,7 @@ This is a **reference-based model**—we don't sync standards into repositories.
3leaps/crucible/
├── config/ # Configuration data (YAML/JSON, schema-validated)
│ ├── agentic/
│ │ └── roles/ # AI agent role prompts (13 baseline roles)
│ │ └── roles/ # AI agent role prompts (20 definitions)
│ └── classifiers/
│ └── dimensions/ # Classifier dimension definitions (7 dimensions)
├── docs/ # Standards documentation
Expand Down Expand Up @@ -151,21 +151,28 @@ Key targets:

Baseline role prompts for AI-assisted development sessions. Each role shapes how an agent approaches work through context engineering. Roles carry a **tier** — default guidance that adopting repos may re-tier: **core** (always-on spine), **supplemental** (adopt by need), **deprecated** (retired). See [PDR-0003](docs/decisions/PDR-0003-role-portfolio-tiering.md).

| Role | Tier | Category | Purpose |
| -------------- | ------------ | ---------- | ------------------------------------- |
| `devlead` | core | agentic | Implementation, architecture |
| `devrev` | core | review | Code review, four-eyes audit |
| `secrev` | core | review | Security analysis |
| `cxotech` | core | governance | Strategic fulcrum, brief/ADR approval |
| `entarch` | supplemental | governance | Cross-repo architecture coherence |
| `infoarch` | supplemental | agentic | Documentation, schemas |
| `dataeng` | supplemental | agentic | Data engineering, pipelines |
| `prodmktg` | supplemental | agentic | Product messaging, personas |
| `qa` | supplemental | review | Testing, validation |
| `releng` | supplemental | automation | Versioning, releases |
| `dispatch` | supplemental | governance | Session coordination |
| `deliverylead` | supplemental | governance | Delivery coordination (large efforts) |
| `cicd` | deprecated | automation | Retired — use `releng` + `devlead` |
| Role | Tier | Category | Purpose |
| -------------- | ------------ | ---------- | ---------------------------------------- |
| `devlead` | core | agentic | Implementation, architecture |
| `devrev` | core | review | Code review, four-eyes audit |
| `secrev` | core | review | Security analysis |
| `cxotech` | core | governance | Strategic fulcrum, brief/ADR approval |
| `entarch` | supplemental | governance | Technology-side architecture coherence |
| `uxdev` | supplemental | agentic | Interactive experience implementation |
| `analyst` | supplemental | analytics | Evidence and decision-ready findings |
| `strategist` | supplemental | consulting | Strategic choices and advice |
| `watcher` | supplemental | automation | Bounded monitoring and escalation |
| `delegate` | supplemental | governance | Privileged, compartmented assistance |
| `secops` | supplemental | automation | Privileged infrastructure operations |
| `projectmgr` | supplemental | governance | Project tasking, state, and risk |
| `infoarch` | supplemental | agentic | Documentation, schemas |
| `dataeng` | supplemental | analytics | Data architecture, pipelines, lineage |
| `prodmktg` | supplemental | marketing | Product positioning and messaging |
| `releng` | supplemental | automation | Complex release systems |
| `dispatch` | supplemental | governance | Estate routing and coordination |
| `qa` | deprecated | review | Retired — use `devrev` + task acceptance |
| `deliverylead` | deprecated | governance | Retired — use `projectmgr` |
| `cicd` | deprecated | automation | Retired — use `releng` + `devlead` |

See [config/agentic/roles/README.md](config/agentic/roles/README.md) for full catalog and usage.

Expand Down
Loading