Skip to content

fix: add dependency existence verification to design workflow#147

Merged
shinpr merged 1 commit intomainfrom
feature/improve-design-doc-review
Mar 29, 2026
Merged

fix: add dependency existence verification to design workflow#147
shinpr merged 1 commit intomainfrom
feature/improve-design-doc-review

Conversation

@shinpr
Copy link
Copy Markdown
Owner

@shinpr shinpr commented Mar 29, 2026

Summary

  • Add Dependency Existence Verification step to technical-designer and technical-designer-frontend agents — verifies each assumed dependency via Grep/Glob before design proceeds, with three-way classification (found in codebase / external dependency / requires new creation)
  • Add dependency realizability check to document-reviewer Gate 1 — cross-checks claimed "existing" dependencies against the codebase during review
  • Applied to both English (agents-en/) and Japanese (agents-ja/) environments

Problem

Design documents could describe components as "existing" without verification. When those dependencies turned out to be missing or had mismatched signatures, it caused implementation failures that were only discovered late in the workflow.

Test plan

  • Run technical-designer on a project referencing a non-existent internal component — verify it is flagged as "requires new creation"
  • Run technical-designer on a project referencing an external API — verify it is recorded as "external dependency"
  • Run document-reviewer on a Design Doc claiming an existing dependency that does not exist — verify critical / feasibility issue is raised
  • Run document-reviewer on a Design Doc where a claimed dependency has a different signature — verify important / consistency issue is raised

🤖 Generated with Claude Code

Design documents could reference non-existent components as "existing"
dependencies without verification, leading to implementation failures.
Add verification step to technical-designer agents and realizability
check to document-reviewer Gate 1.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@shinpr shinpr self-assigned this Mar 29, 2026
@shinpr shinpr merged commit b154d3e into main Mar 29, 2026
1 check passed
@shinpr shinpr deleted the feature/improve-design-doc-review branch April 6, 2026 02:01
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.

1 participant