Skip to content

Conversation

@jakedee
Copy link
Contributor

@jakedee jakedee commented Dec 18, 2025

This refactor makes the function of the initialize-spec.md workflow a bit clearer and fixes a typo in the command. It also removes a reference to a command that no longer exists.

This update makes the function of the `initialize-spec.md` workflow a bit clearer
Correct the next command name
@jakedee jakedee changed the title refactor: initialize-spec.md to increase clarity Increase initialize-spec clarity and fix typo Dec 18, 2025
Remove unavailable command and associated output
@jakedee jakedee changed the title Increase initialize-spec clarity and fix typo Increase initialize-spec clarity, fix typo and remove reference to unavailable command Dec 18, 2025
@emmaanuel
Copy link

Hi, there is a step numbering problem in the initialize-spec.md file.

@jakedee
Copy link
Contributor Author

jakedee commented Dec 29, 2025

Thanks @emmaanuel! That's been fixed

dchuk added a commit to dchuk/agent-os that referenced this pull request Jan 12, 2026
…pstream PR buildermethods#294

Adapt improvements from buildermethods/agent-os PR buildermethods#294 to work with our
JSON-based workflow system. These changes prevent false task completion and
improve refactoring task handling.

Changes to implement-tasks.md:
- Add CLAUDE.md reading instruction for project-specific rules
- Add skills discovery via <available_skills> section
- Add 6 critical task completion rules:
  - Rule 1: Tasks complete only when actually executed
  - Rule 2: Handle missing prerequisites (start services, don't install deps)
  - Rule 3: Task groups require all tasks complete
  - Rule 4: TDD phases require actual test execution
  - Rule 5: Verification tasks require evidence
  - Rule 6: Incomplete tasks must stay incomplete

Changes to create-tasks-list.md:
- Add Step 1.5: Spec completeness verification for refactoring tasks
- Run grep searches to find all affected files before creating tasks
- Document gaps between spec and actual codebase impact

Changes to research-spec.md:
- Add Question 8 for impact analysis during requirements gathering
- Add Impact Analysis section to requirements.md template
- Capture affected areas for refactoring tasks

Changes to write-spec.md:
- Add Step 2.5: Comprehensive impact analysis for refactoring
- Add "Files Requiring Modification" section to spec.md template
- Check for duplicate definitions and related mappings

Note: PRs buildermethods#301 (Chrome alias) and buildermethods#292 (separate subagents) were already
merged. PR buildermethods#293 (init-spec clarity) not applicable due to JSON workflow rewrite.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
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.

2 participants