Files
grm/docs/specs/GRM-171.md
T
kireto fe684bad50
Post-merge / detect-and-configure (push) Successful in 50s
Post-merge / release-and-maintain (push) Successful in 3m6s
GRM-171: docs: add runner-ops, molecule-testing, vikunja-tasks skills, fix create-task docs
2026-09-18 22:48:26 +00:00

1.8 KiB

GRM-171: Add runner-ops, molecule-testing, vikunja-tasks skills, fix create-task docs

Problem

The OBL-INFRA-548 programme audit found grm lacks skills for runner fleet operations (needed for S08: leases, admission, watermarks), molecule scenario authoring, and Vikunja task lifecycle. devx-workflow and AGENTS.md document make create-task -- --title, which fails because devx-create-task forwards no arguments.

Approach

REQ-1: Add runner-ops skill: RunnerManager/AnsibleExecutor model, stale-runner cleanup, image pruning, molecule container lifecycle, safe-debugging rules. REQ-2: Add molecule-testing skill: gitea_runner scenario layout, platform overrides, isolation flags, debugging. REQ-3: Add vikunja-tasks skill: create via module call, query, close, spec-collision convention. REQ-4: Fix broken make create-task -- --title documentation in devx-workflow skill and AGENTS.md. REQ-5: Add skill validation tests (tests/unit/test_skills_validation.py)

  • fix stale make-target refs and missing sections in existing skills.

Preserve the colliding spec as GRM-171-kireto-token-historical.

Test Plan

  • pytest tests/unit/test_skills_validation.py passes (12 tests).

Deploy Plan

Documentation/skills only — auto-merge to master; no runtime deploy.

Rollback Plan

Revert the squash-merge commit; skills are inert documentation.

Acceptance Criteria

  • REQ-1: runner-ops skill exists.
  • REQ-2: molecule-testing skill exists.
  • REQ-3: vikunja-tasks skill exists.
  • REQ-4: create-task docs corrected.
  • REQ-5: Skill validation tests added and passing.

Out of Scope

  • Runner lease/admission implementation (S08 scope).
  • Fixing devx-create-task argument forwarding (devx repo, S11).