feat(task-format): new skill v0.1.0 — poller task-block format reference

Public reference for the on-disk .tasks/STATUS.md block format the autonomous
poller parses: header regex, status emoji, and the **Weight:** / **Notify:** /
**Requirements:** fields. Ships with factory where the internal wiki and MCP
source can't reach. Distinct from delegate-task (MCP-tool delegation) and
using-tasks (board mechanics).

Authored via superpowers:writing-skills TDD:
- RED: 3 baseline subagents w/o skill — 2/3 used ###/bullet headers the parser
  cannot recognize as a task, 2/3 omitted **Weight:** (invented risk/tier/
  claimable-by), 2/3 put notify in prose, 1/3 used 🟢 for a ready task.
- GREEN: 2 fresh subagents w/ skill — both parser-valid, incl. correct
  **Weight:** needs-human for the critical-infra scenario.
- REFACTOR: no new format loopholes.

Ground truth verified vs live source (status-md.ts parser, claim.ts gate,
fleet-router.js routing): missing Weight finds no backend tier -> poller parks
to blocked, so Weight is operatively required for pickup.

Closes [create-task-format-for-poller-skill]. Install to ~/.claude/skills +
hermes mapping deferred as follow-up.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
2026-06-11 12:21:24 +03:00
parent 76c86a793f
commit a71ed9bf07
5 changed files with 149 additions and 16 deletions

View File

@@ -1,5 +1,5 @@
# Task Board
_Updated: 2026-06-09 — using-markitdown-cli-rewrite-review done (VERDICT PASS; SKILL.md без `mcp__markitdown__`, CLI-примеры совпадают с `markitdown 0.1.6 --help`, version 1.0.0→1.0.1 PATCH, dist консистентен; 1 informational finding — docker-контейнер респаунится из out-of-scope `~/.claude.json` MCP-регистрации → follow-up `using-markitdown-mcp-deregister` needs-human). Ранее: skill-using-system-snapshot-review done (VERDICT PASS 3/3; live tool-contract verify + 9-way fresh-context trigger test, 8 clean; 3 informational findings, none blocking — incl. missing deployment scaffold: skill not installed / not in hermes-mapping / no baseline tasks). Ранее: using-tasks-status-read-perf done (using-tasks 1.2.0→1.3.0; done-task archival rule fixes STATUS.md bloat; literal `tasks_get_status`-for-orientation swap NOT done — tool can't enumerate the board, documented). Ранее: session-break-using-tasks done (using-tasks 1.1.0→1.2.0; `session_break` marker — stop after close before claim-next). Ранее: delegate-task-review done (VERDICT PASS; smoke-test 6/6 fresh subagents, no blocking findings, 3 informational notes). Ранее: delegate-task-test-trigger done (pos 5/5, neg 2/3; FP на «создать задачу себе» → follow-up delegate-task-description-fp-fix, shipped v0.2.1). Ранее (2026-06-08): откат churn'а от агент-раннера (always-on dry-run): 5 тасок (using-yt-tools-rate-limit-guard, archive-roundtrip-test, skills-grouping-revisit, hermes-converter-ci, tdd-criteria-precommit-hook) спуриозно claimed/blocked из-за workspace-divergence бага раннера → возвращены в ⚪ ready. yt-tools re-scoped на plugin-репо `OpeItcLoc03/yt-tools` (исходный stub deprecated)._
_Updated: 2026-06-11 — task-format skill v0.1.0 created (TDD via writing-skills; RED 3-fail → GREEN 2-pass). Ранее: using-markitdown-cli-rewrite-review done (VERDICT PASS; SKILL.md без `mcp__markitdown__`, CLI-примеры совпадают с `markitdown 0.1.6 --help`, version 1.0.0→1.0.1 PATCH, dist консистентен; 1 informational finding — docker-контейнер респаунится из out-of-scope `~/.claude.json` MCP-регистрации → follow-up `using-markitdown-mcp-deregister` needs-human). Ранее: skill-using-system-snapshot-review done (VERDICT PASS 3/3; live tool-contract verify + 9-way fresh-context trigger test, 8 clean; 3 informational findings, none blocking — incl. missing deployment scaffold: skill not installed / not in hermes-mapping / no baseline tasks). Ранее: using-tasks-status-read-perf done (using-tasks 1.2.0→1.3.0; done-task archival rule fixes STATUS.md bloat; literal `tasks_get_status`-for-orientation swap NOT done — tool can't enumerate the board, documented). Ранее: session-break-using-tasks done (using-tasks 1.1.0→1.2.0; `session_break` marker — stop after close before claim-next). Ранее: delegate-task-review done (VERDICT PASS; smoke-test 6/6 fresh subagents, no blocking findings, 3 informational notes). Ранее: delegate-task-test-trigger done (pos 5/5, neg 2/3; FP на «создать задачу себе» → follow-up delegate-task-description-fp-fix, shipped v0.2.1). Ранее (2026-06-08): откат churn'а от агент-раннера (always-on dry-run): 5 тасок (using-yt-tools-rate-limit-guard, archive-roundtrip-test, skills-grouping-revisit, hermes-converter-ci, tdd-criteria-precommit-hook) спуриозно claimed/blocked из-за workspace-divergence бага раннера → возвращены в ⚪ ready. yt-tools re-scoped на plugin-репо `OpeItcLoc03/yt-tools` (исходный stub deprecated)._
<!--
Canonical layout. One block per task. Per-task deep context lives in
@@ -951,23 +951,16 @@ No `consult` was needed; nothing irreversible or cross-cutting. Files changed: `
**Источник:** finding из `using-markitdown-cli-rewrite-review` (2026-06-09). Импл-таска `using-markitdown-cli-rewrite` удалила существовавшие контейнеры корректно, но оставила MCP-регистрацию (out of scope, явно флагнуто в `.wiki/concepts/using-markitdown-cli-migration.md` §Out of scope). На ревью контейнер `boring_spence` уже респаунился.
**Weight:** needs-human — правка user-global `~/.claude.json` + keep-or-drop решение: после rewrite скил советует CLI, но MCP-тул `mcp__markitdown__convert_to_markdown` ещё зарегистрирован. Подтвердить с владельцем что MCP больше не нужен, затем удалить запись + `docker rm -f $(docker ps -aq --filter "ancestor=markitdown-mcp:latest")` + (опц.) `docker rmi markitdown-mcp:latest`.
<<<<<<< HEAD
**Status:** done
**Where I stopped:** Confirmed by owner: MCP not needed. Removed mcpServers.markitdown from ~/.claude.json, docker rm containers, docker rmi markitdown-mcp:latest (1.52GB freed).
**Next action:** (none — kept until merged)
=======
**Status:** blocked — parked for human via `consult` (halt; `consult_policy=human-only`, decided_by=human-required). Deep context + resume brief: `.tasks/using-markitdown-mcp-deregister.md`.
**Where I stopped:** Подтвердил фактическое состояние (mcpServers.markitdown в `~/.claude.json`; контейнер `kind_cohen` респаунился Up ~1m; образ `markitdown-mcp:latest` 1.52GB). Перед мутацией user-global конфига вызвал `consult` → halt. Конфиг/контейнеры/образ НЕ тронуты.
**Next action:** Дождаться ответа владельца: нужен ли ещё MCP-тул `mcp__markitdown__convert_to_markdown`? Нет → удалить `mcpServers.markitdown` из `~/.claude.json` + `docker rm -f $(docker ps -aq --filter "ancestor=markitdown-mcp:latest")` + опц. `docker rmi markitdown-mcp:latest`. Да → закрыть wontfix (критерий #2 = "removed at impl time", respawn by design).
**Blocker:** human keep-or-drop decision (consult parked, human-only policy) — see `.tasks/using-markitdown-mcp-deregister.md`.
>>>>>>> 1bc7615 (meta(tasks): park [using-markitdown-mcp-deregister] for human (consult halt))
**Branch:** n/a
<!-- created-by: DESKTOP-NSEF0UK:claude-opus:11584 / from: using-markitdown-cli-rewrite-review finding / 2026-06-09 -->
<!-- closed-by: OpeItcLoc03@DESKTOP-NSEF0UK / 2026-06-09T18:00:53.166Z / note: Confirmed by owner: MCP not needed. Removed mcpServers.markitdown from ~/.claude.json, docker rm containers, docker rmi markitdown-mcp:latest (1.52GB freed). -->
---
## 🔴 [create-task-format-for-poller-skill] — Создать скил `task-format` в `claude-skills/skills/` по TDD-процессу (`superpowers:writing-skills`).
## 🟢 [create-task-format-for-poller-skill] — Создать скил `task-format` в `claude-skills/skills/` по TDD-процессу (`superpowers:writing-skills`).
**Weight:** needs-claude
@@ -1001,14 +994,12 @@ No `consult` was needed; nothing irreversible or cross-cutting. Files changed: `
**Источники:** `agenda/concepts/task-format-agent-poller` + `OpeItcLoc03/common/.wiki/concepts/agents-task-runner-ops.md`
**Status:** active
**Where I stopped:** (not started)
**Next action:** Прочитать `agenda/concepts/task-format-agent-poller`. Запустить baseline-субагент без скила — зафиксировать нарушения (Weight/Notify).
**Branch:** n/a
**Status:** done
**Where I stopped:** Skill shipped — `skills/task-format/SKILL.md` v0.1.0 + `.wiki/concepts/task-format-design.md`. TDD per writing-skills: RED (3 baseline subagents — 2/3 used `###`/bullet headers the parser can't recognize, 2/3 omitted Weight, 2/3 notify-in-prose, 1/3 🟢-for-ready) → GREEN (2 fresh subagents, both parser-valid incl. correct `needs-human` for critical-infra) → REFACTOR clean. Ground truth verified vs `status-md.ts` + `claim.ts` + `fleet-router.js` (the `agenda/concepts/task-format-agent-poller` source named in next-action doesn't exist on disk; used the live parser/router source instead — strictly more authoritative).
**Next action:** (none — kept until merged)
**Branch:** master
**Notify:** OpeItcLoc03/workshop
**Owner:** DESKTOP-NSEF0UK:claude-opus:30508
**Claim token:** 43a6ad53-b957-4467-9018-bc4b418406f1
**Claim expires at:** 2026-06-11T09:29:06.009Z
<!-- created-by: OpeItcLoc03@DESKTOP-NSEF0UK / from: OpeItcLoc03/workshop / 2026-06-11T08:39:18.657Z -->
<!-- closed-by: DESKTOP-NSEF0UK:claude-opus / 2026-06-11 / note: closed by inspection — TDD evidence (RED 3-fail / GREEN 2-pass subagent runs) is the acceptance coverage for a markdown skill; install to ~/.claude/skills + hermes mapping deferred as a follow-up (mirrors using-system-snapshot deployment-scaffold note) -->
---