Skip to content

Conversation

Copy link
Contributor

Copilot AI commented Nov 1, 2025

Teams accumulate verbose specification files over time. Without compaction, project directories become cluttered with implementation details that distract from milestone transitions.

Changes

  • New command: /awos:compact compacts specs into summaries (~30-50% size reduction)

    • Creates functional-spec-compact.md - preserves rationale, core requirements, acceptance criteria
    • Creates technical-considerations-compact.md - preserves architectural decisions, key approaches, risks
    • Creates completed-summary.md - single-page feature overview with completion date
  • Smart validation: Detects already-compacted specs, warns on incomplete tasks (- [ ] pattern)

  • Optional archiving: Moves original detailed files to context/archive/ to declutter active specs

  • Scope control: Process single spec by name/index or batch all specs in context/spec/

Usage

# Compact all specs
/awos:compact

# Compact specific spec
/awos:compact 001-user-authentication

The command follows existing patterns (ROLE/TASK/PROCESS structure) and integrates automatically via wildcard file copying in setup config.

Original prompt

This section details on the original issue you should resolve

<issue_title>Add "compact" command for specs</issue_title>
<issue_description>awos produces a large number of spec files over time. To keep projects manageable, teams should be able to compact these specs after each milestone.

We need a awos:compact command that takes all the detailed specs and produces a concise summary version, removing distracting details while keeping the important information. This will prevent the project from turning into a mess of markdown files and make it easier to move from milestone to milestone.</issue_description>

Comments on the Issue (you are @copilot in this section)


💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.

Copilot AI changed the title [WIP] Add compact command for specs management Add /awos:compact command for spec compaction Nov 1, 2025
Copilot AI requested a review from workshur November 1, 2025 15:01
Copilot finished work on behalf of workshur November 1, 2025 15:01
@workshur workshur closed this Nov 11, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Add "compact" command for specs

2 participants