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) 

 

 ← Design Pattern |
 Audit Summary