2.8 KiB
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-covto 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
- REQ-1:
.devin/skills/dependency-graph/SKILL.mdexists with ecosystem map, dependency chain, correct change order, and state verification sections - REQ-2:
.devin/skills/deployment-coordination/SKILL.mdexists with release flow, downstream consumer table, coordination steps, and common mistakes - REQ-3:
.devin/skills/skill-creation/SKILL.mdexists with skill structure template, quality standards, scope rules, automated validation, and creation checklist