Add shared body-style reference for backlog-writing skills #408

Closed
opened 2026-08-15 18:09:06 +00:00 by jared · 1 comment
Owner

Context

Two formatting failures on 2026-08-15: issue #407's body was written with bare [ ] lines (non-rendering checkboxes), and the fix agent then hard-wrapped the body mid-sentence. Freeform tracker writers carry no style rules today.

Tasks

  • Create plugins/os-backlog/references/body-style.md (~10 lines): - [ ] checkbox list syntax, one item/paragraph per line (soft wrap, never reflow existing text), section order (Context / Tasks / Acceptance criteria / In-scope-Out-of-scope / Blocking edges), large text via body edit never comment, delegate tracker writes to haiku with this file inlined in the prompt.
  • Inject it via dynamic !cat`` context injection into skills/capture/SKILL.md and skills/ticket-decompose/SKILL.md.
  • Pointer-only references from plugins/os-sdlc/skills/mine-lints/SKILL.md and plugins/os-backlog/skills/route/references/cross-project-filing.md.
  • Shrink ticket-decompose's run-on 'Tracker writes' paragraph to a short rule pointing at the style file.
  • Rider: run bin/refresh-plugins.

Acceptance criteria

  • body-style.md exists and is injected (not just linked) in capture and ticket-decompose.
  • mine-lints and cross-project-filing point at it without duplicating its rules.
  • No comment agent is created — CLI-templated comments (Resolution/Start/Bounced) stay as-is.

Out of scope

Ruby changes to bin/os-backlog or lib/; any new agent definition.

## Context Two formatting failures on 2026-08-15: issue #407's body was written with bare `[ ]` lines (non-rendering checkboxes), and the fix agent then hard-wrapped the body mid-sentence. Freeform tracker writers carry no style rules today. ## Tasks - [ ] Create `plugins/os-backlog/references/body-style.md` (~10 lines): `- [ ]` checkbox list syntax, one item/paragraph per line (soft wrap, never reflow existing text), section order (Context / Tasks / Acceptance criteria / In-scope-Out-of-scope / Blocking edges), large text via body edit never comment, delegate tracker writes to haiku with this file inlined in the prompt. - [ ] Inject it via dynamic `!`cat`` context injection into `skills/capture/SKILL.md` and `skills/ticket-decompose/SKILL.md`. - [ ] Pointer-only references from `plugins/os-sdlc/skills/mine-lints/SKILL.md` and `plugins/os-backlog/skills/route/references/cross-project-filing.md`. - [ ] Shrink ticket-decompose's run-on 'Tracker writes' paragraph to a short rule pointing at the style file. - [ ] Rider: run `bin/refresh-plugins`. ## Acceptance criteria - [ ] body-style.md exists and is injected (not just linked) in capture and ticket-decompose. - [ ] mine-lints and cross-project-filing point at it without duplicating its rules. - [ ] No comment agent is created — CLI-templated comments (Resolution/Start/Bounced) stay as-is. ## Out of scope Ruby changes to bin/os-backlog or lib/; any new agent definition.
Author
Owner

Resolution

Done: Created plugins/os-backlog/references/body-style.md (checkbox syntax, one-line/soft-wrap no-reflow rule, section order, body-edit-not-comment, os-backlog-comment-never-tea, haiku delegation with file inlined); !cat-injected into capture and ticket-decompose SKILL.md; ticket-decompose 'Tracker writes' paragraph shrunk to a pointer rule; one-sentence pointers added in os-sdlc mine-lints and route cross-project-filing.md; bin/refresh-plugins ran clean.

Evidence: Diff verified on main thread: 4 files changed +11/-3 plus new body-style.md; capture allowed-tools extended to permit the injection cat; refresh-plugins refreshed both marketplaces without errors. Commit to follow in session wrap.

Follow-ups: none

## Resolution **Done:** Created plugins/os-backlog/references/body-style.md (checkbox syntax, one-line/soft-wrap no-reflow rule, section order, body-edit-not-comment, os-backlog-comment-never-tea, haiku delegation with file inlined); !cat-injected into capture and ticket-decompose SKILL.md; ticket-decompose 'Tracker writes' paragraph shrunk to a pointer rule; one-sentence pointers added in os-sdlc mine-lints and route cross-project-filing.md; bin/refresh-plugins ran clean. **Evidence:** Diff verified on main thread: 4 files changed +11/-3 plus new body-style.md; capture allowed-tools extended to permit the injection cat; refresh-plugins refreshed both marketplaces without errors. Commit to follow in session wrap. **Follow-ups:** none
jared closed this issue 2026-08-15 18:11:34 +00:00
Sign in to join this conversation.
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set

Reference
jared/cc-os#408
No description provided.