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

52 lines
1.8 KiB
Markdown

# 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](GRM-171-kireto-token-historical.md).
## 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
- [x] REQ-1: `runner-ops` skill exists.
- [x] REQ-2: `molecule-testing` skill exists.
- [x] REQ-3: `vikunja-tasks` skill exists.
- [x] REQ-4: create-task docs corrected.
- [x] 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).