Skip to content

feat: Add AI-assisted setup path for complex repos (setup.sh --ai)#2

Draft
mlgitdev wants to merge 1 commit into
itseffi:mainfrom
mlgitdev:feature/complex-repo-auto-setup
Draft

feat: Add AI-assisted setup path for complex repos (setup.sh --ai)#2
mlgitdev wants to merge 1 commit into
itseffi:mainfrom
mlgitdev:feature/complex-repo-auto-setup

Conversation

@mlgitdev

Copy link
Copy Markdown

Summary

  • Adds an AI-installer skill that enables intelligent, complexity-aware setup for existing repositories
  • setup.sh --ai bootstraps workspace infrastructure and invokes the AI which scans, classifies (Zero/Simple/Multi/Complex), proposes config, and writes after approval
  • Supports 4 runtimes: Claude Code, Cursor, Cline, Antigravity
  • Non-destructive: never modifies user files, uses companion file pattern
  • Clean uninstall via setup.sh --remove

Key Features

  • --target <path> — run against any repo without cd
  • --auto — unattended execution (requires explicit --runtime)
  • --dry-run — preview without writing
  • Framework coexistence — defers persona routing when BMAD detected
  • Workspace bootstrapping — copies skills, workflows, dirs into target
  • AI infers GOALS.md from repo structure (replaces questionnaire)

Verification Status

  • ✅ Claude Code — tested against complex tier repo (BMAD, 54 skills, 7 concern folders)
  • ✅ Cursor — tested, generated 4 .cursor/rules/ (806-809), proper numbering, no collisions
  • ✅ Shell tests: 29/29 passed
  • ✅ Python tests: 24/24 passed
  • ⬜ Cline, Antigravity — not tested (no environment), requesting reviewer validation

Test plan

  • Run sh tests/test_setup.sh — all 29 pass
  • Run pytest tests/test_content.py — all 24 pass
  • Run ./setup.sh --ai --target examples/uj-3-flask-simple --runtime claude and invoke /agentic-os-setup
  • Verify setup.sh --remove cleanly removes all generated files
  • Test against your own real-world repo and report unexpected classifications

Planning Methodology

Planned using BMad Method. Artifacts in _bmad-output/prd-ai-assisted-setup-2026-06-20/.

🤖 Generated with Claude Code

Adds an AI-installer skill that enables intelligent, complexity-aware setup
for existing repositories. Users run setup.sh --ai to bootstrap workspace
infrastructure and invoke the AI skill which scans repo structure, classifies
complexity (Zero/Simple/Multi/Complex), proposes configuration proportional
to detected needs, previews as unified diffs, and writes after approval.

Key capabilities:
- Workspace bootstrapping (dirs, skills, workflows, AGENTS.md inference)
- 4 runtime adapters (Claude, Cursor, Cline, Antigravity)
- --target for running against external repos
- --auto for unattended execution (requires explicit --runtime)
- Non-destructive: never modifies user files, companion file pattern
- Framework coexistence (defers persona routing when BMAD detected)
- Clean uninstall via setup.sh --remove (manifest-tracked)
- Test infrastructure: shell + Python tests, 4 UJ-based fixtures

Planned using BMad Method. Planning artifacts in _bmad-output/.

Co-Authored-By: Claude Opus 4.6 (1M context) <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