cwf-extract

name	cwf-extract
description	Extract specific section from implementation guide (v2.0 - task-based)
user-invocable	true
allowed-tools	["Read","Bash"]

Scope & Boundaries

This step: Extract and display a specific section from a task's workflow files. Not this step: Modifying tasks or advancing workflow phases.

Context

Task arguments: {arguments}

First: Run .cwf/scripts/command-helpers/context-manager location using the Bash tool to confirm git root.

Workflow

Parse arguments: <task-path> <section-name>

• task-path: Task number (e.g., "1", "1.1") OR full file path (backward compatible)
• section-name: Section to extract (case-insensitive)

Examples:

• /cwf-extract 1 goal — Extract Goal section from task 1's plan
• /cwf-extract 1.1 requirements — Extract from task 1.1's requirements file

1. Determine Input Type

• Contains "/" or ends with ".md": treat as file path (backward compatible)
• Otherwise: resolve via context-manager hierarchy <task-path>

2. Map Section to File

• "goal"/"plan" -> a-task-plan.md / a-plan.md / plan.md
• "requirements" -> b-requirements-plan.md / b-requirements.md / requirements.md
• "design" -> c-design-plan.md / c-design.md / design.md
• "implementation" -> d-implementation-plan.md / d-implementation.md / implementation.md
• "testing" -> e-testing-plan.md / e-testing.md / testing.md
• "rollout" -> h-rollout.md / f-rollout.md / rollout.md
• "maintenance" -> i-maintenance.md / g-maintenance.md / maintenance.md
• "retrospective" -> j-retrospective.md / h-retrospective.md
• Use context-manager version <task-dir> <workflow-file> to determine format

3. Extract Section

awk '/^## {section-name}/{p=1; print; next} p && /^## [^#]/{p=0} p' {file-path}

4. Error Handling

• If not found: list available sections, suggest closest match, ask for clarification

Success Criteria

• Task and section resolved
• Section content extracted and displayed
• Error handling for missing sections