PoC: task-postflight
PoC: task-postflight Refactor
Source: /tmp/pillar4-99131-out/poc-task-postflight-tier1.md + ~/system/specs/agentic-os-pillar4-skills-audit-2026-05-04.md (§6)
MC: #99131 | #99176
Branch: feat/pillar4-skills-poc (merged to master 2026-05-05 ef8536ad)
Date: 2026-05-05
Overview
The PoC refactor of task-postflight/SKILL.md validates the three-tier progressive disclosure pattern on the highest-priority target.
- Target: 541 LOC → ≤ 200 LOC core trigger skeleton
- New references/ files:
anomaly-decision-tree.md,proveo-rubric.md,memory-writer.md - Existing references/ preserved:
proveo-brief.md,learning-loop.md(unchanged)
Token Reduction Analysis
| Metric | Before | After (PASS path) | After (ANOMALY path) |
|---|---|---|---|
| SKILL.md LOC | 541 | ≤190 | ≤190 |
| SKILL.md bytes | 19,859 | ~8,200 | ~8,200 |
| Tokens loaded | 5,367 | ~2,216 | ~2,216 |
| Additional refs loaded | 0 | 0 | ~3,000 (anomaly-decision-tree) |
| Total tokens (PASS path) | 5,367 | 2,216 | N/A |
| Reduction on PASS path | — | 59% | — |
| Bytes reduction check | — | 11,659 bytes saved / 19,859 = 58.7% ≥ 40% | PASS |
The ≥40% byte reduction target is met on the typical PASS path. On anomaly paths, the anomaly-decision-tree.md is loaded (~3,000 additional tokens) but this is appropriate because the anomaly path requires that content.
PoC Target Rationale
Selection: task-postflight
Priority score comparison:
| Skill | tokens_est | inv_30d | priority_score |
|---|---|---|---|
| task-postflight | 5,367 | 21 | 82.054 |
| prompt-forge | 2,372 | 20 | 70.877 |
| doc-coauthoring | 4,274 | 0 | 3.631 |
| product-lifecycle | 5,103 | 0 | 3.708 |
Petter's preference for doc-coauthoring (376L, clean three-stage structure) was overridden by frequency data. task-postflight fires on every H/BLOCKER closure — 21 times in 19 days. doc-coauthoring has 0 measured invocations. Frequency × size dominates structural elegance.
Trigger-Map Table
Content migration plan (required before coding per D3 pre-refactor requirement):
| Current SKILL.md section | Lines | Always needed? | Move to |
|---|---|---|---|
| Frontmatter (description) | 8 | YES — trigger | Keep in SKILL.md |
| §1 Preconditions | 32 | YES — fail fast | Keep in SKILL.md |
| §2 Proveo dispatch | 40 | YES — every invocation | Keep in SKILL.md |
| §3 Anomaly decision tree | 38 | NO — only after Proveo returns | → references/anomaly-decision-tree.md |
| §4 Learning-opportunity dispatch template | 62 | NO — only on ANOMALY path | → references/anomaly-decision-tree.md |
| §5 Memory writer procedure | 38 | NO — only if learning returns memory | → references/memory-writer.md |
| §6 Postflight marker writer | 72 | PARTIAL — Section 6a-6b always needed, 6c-6f only on success path | 6a-6b keep; 6c-6f → references/marker-writer.md |
| §7 mc.js ready writer | 52 | PARTIAL — format in SKILL.md; details → references/ | Keep dispatch shape; move table → references/ |
| §8 Failure modes table | 30 | NO — reference only | → references/anomaly-decision-tree.md |
| §9 Audit trail | 20 | YES — always runs | Keep in SKILL.md |
| v0.1 TODO + References footer | 30 | NO | Drop from PoC (TODO deferred) |
Content Split
Stage 1 content (stays in SKILL.md core)
- Preconditions (1a-1c)
- Proveo dispatch inputs and expected output format
- Anomaly routing decision (IF/THEN — 4 cases, each with "Read ./references/anomaly-decision-tree.md")
- Postflight marker check (6a-6b only)
- mc.js ready submission shape
- Audit trail append
Stages 2-N content (moved to references/)
- Full anomaly class decision tree →
references/anomaly-decision-tree.md - Learning-opportunity invocation template →
references/anomaly-decision-tree.md(same file, appended) - Memory writer procedure →
references/memory-writer.md - Marker writer full procedure (6c-6f) →
references/marker-writer.md - Failure modes table → appended to
references/anomaly-decision-tree.md
Existing references/ files
references/proveo-brief.md— keep as-is (already correct progressive disclosure)references/learning-loop.md— keep as-is
Verification Commands
# 1. Branch exists
git -C /Users/makinja/.claude branch --list "feat/pillar4-skills-poc"
# 2. LOC check
wc -l /Users/makinja/.claude/skills/task-postflight/SKILL.md # must be <= 200
# 3. Reference files exist
ls /Users/makinja/.claude/skills/task-postflight/references/anomaly-decision-tree.md
ls /Users/makinja/.claude/skills/task-postflight/references/proveo-rubric.md
ls /Users/makinja/.claude/skills/task-postflight/references/memory-writer.md
# 4. Before/after snapshots exist
ls /tmp/pillar4-99131-out/poc-task-postflight-before.md
ls /tmp/pillar4-99131-out/poc-task-postflight-after.md
# 5. Byte reduction >= 40%
python3 -c "
before=$(wc -c < /tmp/pillar4-99131-out/poc-task-postflight-before.md)
after=$(wc -c < /tmp/pillar4-99131-out/poc-task-postflight-after.md)
print(f'Reduction: {(before-after)/before*100:.1f}%')
print('PASS' if (before-after) >= 0.4*before else 'FAIL')
"
# 6. No section header permanently lost
# Proveo verifies headers in before.md appear in {after.md + 3 ref files}
PR Merged
Branch: feat/pillar4-skills-poc
Merged: 2026-05-05T09:17:35Z
Commit: ef8536adba17
Status: Merged to master
Result: 541 LOC → 194 LOC (64.7% reduction)