mcpField
S
spec-loop-compact-task-file

spec-loop-compact-task-file

github.com/dpolivaevAgent workflows3550 installsUpdated 2w ago
Repository

About spec-loop-compact-task-file

A task-file skill for compacting an active Spec Loop task file without changing its meaning. It removes duplication while preserving decisions, constraints, findings, dependencies, and implementation and test expectations.

Key features

  1. 01Uses the active task file as source of truth
  2. 02Reorganizes content to reduce duplication
  3. 03Preserves decisions and dependencies
  4. 04Retains constraints, findings, and review facts
  5. 05Keeps implementation and test expectations

Use cases

  1. 01Reducing duplication in an active task file
  2. 02Reorganizing shared and subtask-specific context
  3. 03Compacting a task file while preserving review details

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/dpolivaev/spec-loop --skill spec-loop-compact-task-file

After installing, type/spec-loop-compact-task-filein Claude Code to confirm it loaded.

Details

From the project README

Task-file path only.

Source of truth

Use the active task file as the source of truth.

Before compacting, re-read the current subtask and the task-level sections and diagrams it depends on.

Rules

Compaction must preserve meaning exactly.

It may move, rewrite, or reorganize section content to remove duplication and shrink the active task file, but it must preserve:

  • decisions;
  • dependencies;
  • constraints;
  • review-relevant facts;
  • findings; and
  • implementation and test expectations.

Keep shared context at task level. Keep one authoritative location for each piece of section content. Keep brief references or restatements only when remaining work still needs them to understand the current subtask safely.

Allowed changes

  • Move subtask-specific Research, Design, Test specification, and Findings into the relevant subtask.
  • Rewrite duplicated section content into a shorter equivalent form.
  • Reorganize section content to remove duplication and make the active task file smaller.
  • Compact duplicated section content instead of repeating it.

Forbidden changes

Do not use this skill to:

  • make new design decisions;
  • narrow or expand scope;
  • remove still-needed detail; or
  • split the task into multiple files.

Stop conditions

If no compaction is needed under these rules, make no task changes and return control to the invoking workflow.

If compaction reveals a material unresolved question, stop and use spec-loop-clarify-task/SKILL.md.

When compaction is complete, return control to the workflow that invoked this skill.

Comments

Markdown supported