This repository was archived by the owner on Mar 26, 2026. It is now read-only.
Description 📋 Pre-flight Checks
🔍 Problem Description
Agent Teams Lite currently only supports global installation, with hardcoded paths in:
OpenCode commands (~/.config/opencode/skills/sdd-*/SKILL.md)
Agent prompts (opencode.json references global paths)
setup.sh only installs to global directories
This creates several problems for team collaboration:
Global environment pollution – skills and configuration affect all projects
No project-specific customization – cannot have different SDD conventions per project
Team synchronization issues – each developer must manually install/update globally
Hardcoded paths prevent local discovery – OpenCode already supports local skill discovery but agent-teams-lite doesn't use it
💡 Proposed Solution
Add a --local (or --project) flag to setup.sh that enables project-scoped installation:
Phase 1: Local installation mode
./setup.sh --local detects git repo and installs to project directories
Skills go to ./.opencode/skills/, ./.claude/skills/, etc.
Configuration merges into ./.opencode/opencode.json, ./.claude/CLAUDE.md
Commands copy to ./.opencode/commands/ (without hardcoded paths)
Phase 2: Path-agnostic prompts
Remove hardcoded ~/.config/opencode/skills/... references from commands and agent prompts
Rely on OpenCode's built-in skill discovery (local > global hierarchy)
Use skill({name: "sdd-apply"}) instead of explicit file paths
Phase 3: Example project template
Add examples/local-project/ showing the ideal structure
Include documentation for team setup
📦 Affected Area
Scripts (setup, installation)
🔄 Alternatives Considered
Symlinks from global to local – still pollutes global namespace, requires per-user setup
Environment variables to override paths – complex, breaks agent discovery patterns
Manual copy-paste of skills – error-prone, not maintainable
📎 Additional Context
Reactions are currently unavailable
📋 Pre-flight Checks
status:approvedbefore a PR can be opened🔍 Problem Description
Agent Teams Lite currently only supports global installation, with hardcoded paths in:
~/.config/opencode/skills/sdd-*/SKILL.md)opencode.jsonreferences global paths)setup.shonly installs to global directoriesThis creates several problems for team collaboration:
💡 Proposed Solution
Add a
--local(or--project) flag tosetup.shthat enables project-scoped installation:Phase 1: Local installation mode
./setup.sh --localdetects git repo and installs to project directories./.opencode/skills/,./.claude/skills/, etc../.opencode/opencode.json,./.claude/CLAUDE.md./.opencode/commands/(without hardcoded paths)Phase 2: Path-agnostic prompts
~/.config/opencode/skills/...references from commands and agent promptsskill({name: "sdd-apply"})instead of explicit file pathsPhase 3: Example project template
examples/local-project/showing the ideal structure📦 Affected Area
Scripts (setup, installation)
🔄 Alternatives Considered
📎 Additional Context