Skip to content

Conversation

@shinpr
Copy link
Owner

@shinpr shinpr commented Oct 26, 2025

Summary

Adds complete frontend development infrastructure to the AI coding
project boilerplate, enabling React-based web application
development alongside existing backend capabilities. This PR
introduces technology-agnostic rules, specialized agents, and
bilingual support (EN/JA) for frontend workflows.

Key Changes

🎯 Core Features

  • Frontend-specific agents (3 new agents):

    • technical-designer-frontend: Component architecture and
      design decisions
    • task-executor-frontend: TDD-driven implementation with React
      Testing Library
    • quality-fixer-frontend: Comprehensive quality checks (type
      safety, tests, bundle size, coverage)
  • Frontend slash commands (3 new commands):

    • /front-design: Requirements analysis → Design Doc creation
    • /front-plan: Design Doc → Work plan generation
    • /front-build: Autonomous task execution mode
  • Frontend-specific rules (4 new rule files):

    • typescript.md: Props-driven design, function components,
      type safety
    • typescript-testing.md: React Testing Library, MSW, coverage
      targets
    • technical-spec.md: Environment variables, build
      requirements, data flow
    • ai-development-guide.md: Pre-implementation investigation,
      quality checks

🌍 Bilingual Support

  • Full English/Japanese documentation for all agents, commands,
    and rules
  • Consistent terminology across both languages

🔧 Technology-Agnostic Approach

  • Removed version-specific dependencies (React 19 → React)
  • Removed tool-specific dependencies (Vite → build tool)
  • Removed Lighthouse-specific mentions (generic quality process)
  • Props design guidelines: 3-7 props ideal, 50% optional max,
    2-level nesting
  • Coverage targets: 60% overall, component-specific targets
    (Atoms 70%, Molecules 65%, Organisms 60%)

📊 Statistics

  • 29 files changed: +4,360 / -6,862 lines
  • New documentation: 2,100+ lines of frontend-specific rules
  • New agents: 1,900+ lines of specialized agent configurations

🤖 Generated with https://claude.com/claude-code

shinpr and others added 3 commits October 26, 2025 11:24
Add comprehensive frontend development capabilities alongside existing backend support:

**Frontend-specific Agents:**
- quality-fixer-frontend: Lighthouse performance checks, bundle size verification
- task-executor-frontend: React 19 function components, Props-driven design
- technical-designer-frontend: React architecture decisions, Props type contracts

**Frontend Commands:**
- /front-design: Create React/Vite design documents
- /front-plan: Generate frontend work plans
- /front-build: Execute React component implementation

**Frontend Rules:**
- docs/rules-en/frontend/typescript.md: React development standards
- docs/rules-en/frontend/typescript-testing.md: React Testing Library, MSW
- docs/rules-en/frontend/technical-spec.md: Vite, environment variables
- docs/rules-en/frontend/ai-development-guide.md: Lighthouse, bundle size optimization

**Package Updates:**
- Add Vite and React dependencies to devDependencies
- Add frontend npm scripts (build:frontend, dev:frontend, preview)
- Split conflicting commands (build:backend vs build:frontend)
- Remove package-lock.json from tracking (boilerplate best practice)

**Documentation:**
- Update CLAUDE.en.md: Backend/Frontend quality-fixer usage
- Update README.md: Frontend commands, agents, and npm scripts
- Update rules-index.yaml: Frontend rule metadata

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <[email protected]>
フロントエンド向け専門エージェント、コマンド、ルールの日本語版を追加:

Agents (3):
- quality-fixer-frontend: フロントエンド品質修正(Lighthouse、Bundle size対応)
- task-executor-frontend: フロントエンドタスク実行(React 19、Props-driven)
- technical-designer-frontend: フロントエンド設計(React、ADR、Design Doc)

Commands (3):
- front-build: フロントエンド実装実行
- front-design: フロントエンド設計書作成
- front-plan: フロントエンド作業計画書作成

Rules (4):
- typescript.md: React 19関数コンポーネント、Props-drivenアプローチ
- typescript-testing.md: React Testing Library、MSW、80%カバレッジ
- technical-spec.md: Vite、環境変数、Lighthouse要件
- ai-development-guide.md: アンチパターン、デバッグ、品質チェック

Updated:
- CLAUDE.ja.md: quality-fixer差別化(Backend/Frontend)
- README.ja.md: フロントエンドコマンド、npm scripts、品質チェック追加

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <[email protected]>
フロントエンド開発サポート追加によるマイナーバージョンアップ

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <[email protected]>
@shinpr shinpr self-assigned this Oct 26, 2025
フロントエンドコマンドからsub-agents.md参照を削除し、保証されなくなる挙動をsub-agents.mdベースで追記:

変更内容:
- sub-agents.md参照削除(バックエンド向けフローのため不適切)
- サブエージェント呼び出し方法を追記(Taskツール使用)
- 構造化レスポンス仕様を追記(JSON形式)
- コミット実行詳細を追記(メインAIがBashで実行)
- エージェント連携仕様を追記(acceptance-test-generator → work-planner)

影響範囲:
- front-build.md: 自律実行サイクル詳細化
- front-design.md: 実行フロー明確化
- front-plan.md: エージェント連携フロー明確化
- 日本語版も同様に更新

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <[email protected]>
@shinpr shinpr force-pushed the feat/frontend-enhancement branch from f1ccb25 to 4a65a72 Compare October 26, 2025 09:19
Remove version-specific and tool-specific references to make frontend rules more technology-agnostic:
- Replace "React 19" with "React" (modern React standard)
- Replace "Vite" references with generic "build tool"
- Remove Lighthouse-specific mentions from quality process
- Adjust coverage target from 80% to 60% with component-specific targets
- Refine Props design guidelines (3-7 props ideal, 50% optional max, 2-level nesting)

This improves rule portability across different React versions and build tools while maintaining frontend-specific best practices.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <[email protected]>
@shinpr shinpr changed the title frontend enhancement feat: Add comprehensive frontend development support with technology-agnostic rules Oct 26, 2025
- Remove npm cache configuration (no longer requires package-lock.json)
- Change from `npm ci` to `npm install` for dependency installation

This aligns with the boilerplate philosophy where users manage their own dependency lock files.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <[email protected]>
@shinpr shinpr marked this pull request as ready for review October 26, 2025 12:29
@shinpr shinpr merged commit 9a3a6fe into main Oct 26, 2025
1 check passed
@shinpr shinpr deleted the feat/frontend-enhancement branch October 26, 2025 12:29
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