47 lines
2.8 KiB
Markdown
47 lines
2.8 KiB
Markdown
# GRM-173: Add dependency-graph, deployment-coordination, and skill-creation skills
|
|
|
|
## Problem
|
|
Agents working across the oblachno ecosystem lack shared, written context
|
|
for three recurring struggles: (1) knowing which repo produces what and
|
|
the correct order for cross-repo changes, (2) coordinating grm releases
|
|
with the downstream infra dependency PR, and (3) creating and validating
|
|
new Devin skills consistently. Without these skills, agents repeatedly
|
|
make mistakes such as deploying infra before the grm dependency PR is
|
|
merged, or writing skills that fail the validator.
|
|
|
|
## Approach
|
|
Add three skill files under `.devin/skills/`. Two are shared skills
|
|
(`dependency-graph`, `skill-creation`) that must be identical across
|
|
repos; one is grm-specific (`deployment-coordination`). All three
|
|
follow the standard skill structure (H1 title, When to Invoke,
|
|
Prerequisites, core content) and reference real make targets, file
|
|
paths, and API endpoints.
|
|
|
|
REQ-1: Add `.devin/skills/dependency-graph/SKILL.md` — shared skill mapping the oblachno ecosystem (repos, produces/consumers, dependency chain, correct change order, state verification)
|
|
REQ-2: Add `.devin/skills/deployment-coordination/SKILL.md` — grm-specific skill covering release flow, downstream consumer, coordinating a grm change, and common mistakes
|
|
REQ-3: Add `.devin/skills/skill-creation/SKILL.md` — shared skill for creating, validating, and maintaining skills (structure, quality standards, scope rules, automated validation, checklist)
|
|
|
|
## Files Affected
|
|
- `.devin/skills/dependency-graph/SKILL.md` (new)
|
|
- `.devin/skills/deployment-coordination/SKILL.md` (new)
|
|
- `.devin/skills/skill-creation/SKILL.md` (new)
|
|
- `docs/specs/GRM-173.md` (new)
|
|
|
|
## Test Plan
|
|
- Verify all three SKILL.md files follow the required structure (H1, When to Invoke, Prerequisites)
|
|
- Verify referenced make targets and file paths are accurate
|
|
- Run `make pytest-cov` to confirm no test regressions (skills are docs-only, no code changes)
|
|
- Confirm shared skills (`dependency-graph`, `skill-creation`) are ready for cross-repo sync
|
|
|
|
## Deploy Plan
|
|
- Merge to master via auto-merge workflow
|
|
- No runtime changes; documentation-only (`.devin/**` is infrastructure path, no release triggered)
|
|
|
|
## Rollback Plan
|
|
- Revert the merge commit; skill files are removed, no functional impact
|
|
|
|
## Acceptance Criteria
|
|
- [x] REQ-1: `.devin/skills/dependency-graph/SKILL.md` exists with ecosystem map, dependency chain, correct change order, and state verification sections
|
|
- [x] REQ-2: `.devin/skills/deployment-coordination/SKILL.md` exists with release flow, downstream consumer table, coordination steps, and common mistakes
|
|
- [x] REQ-3: `.devin/skills/skill-creation/SKILL.md` exists with skill structure template, quality standards, scope rules, automated validation, and creation checklist
|