Files
grm/docs/specs/GRM-173.md
T
kireto 063623cb9f
Post-merge / detect-and-configure (push) Successful in 59s
Post-merge / release-and-maintain (push) Successful in 5m43s
GRM-173: docs: add dependency-graph, deployment-coordination, and skill-creation skills
2026-09-05 14:17:44 +00:00

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-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

  • REQ-1: .devin/skills/dependency-graph/SKILL.md exists with ecosystem map, dependency chain, correct change order, and state verification sections
  • REQ-2: .devin/skills/deployment-coordination/SKILL.md exists with release flow, downstream consumer table, coordination steps, and common mistakes
  • REQ-3: .devin/skills/skill-creation/SKILL.md exists with skill structure template, quality standards, scope rules, automated validation, and creation checklist