* chore: bump version to v0.8.0
* chore: update version to 0.7.1 instead of 0.8.0
* docs: expand comparison table with Oh My OpenCode and additional features
* backup: development context before reorganization
* refactor(context): reorganize development folder
- Remove 7 duplicate files (ui/design files exist in ui/web/)
- Remove 2 redundant READMEs (use navigation.md instead)
- Move react-patterns.md to frontend/react/
- Create frontend/react/navigation.md
- Update 4 navigation files (development, ui, frontend, frontend/react)
- Update developer profile (4 path changes: ui-styling-standards, design-systems, design-assets, animation-patterns)
- Update 3 core context files (visual-development.md, design-iteration.md, file-locations.md)
Result: 29 context files (down from 36), no duplicates, clean structure
Refs: REORGANIZATION_PLAN.md, REORGANIZATION_SUMMARY.md
* docs(context): add frontend delegation guide
- Create when-to-delegate.md with clear decision criteria
- Decision matrix for when to delegate vs. handle directly
- Common patterns and examples
- Red flags and green flags
- Frontend-specialist capabilities reference
- Update frontend and development navigation files
Helps orchestrators decide when to delegate UI work to frontend-specialist subagent.
* feat: enhance developer and advanced profiles with UI, development, and system builder context
- Developer profile: Add UI/UX patterns, development principles, design systems, React patterns, animation patterns, styling standards, and design assets
- Full profile: Add same UI/development context as developer profile for consistency
- Advanced profile: Add comprehensive system builder context including templates, guides, context system standards, and repository management context
- Update profile descriptions to reflect new capabilities
- All context files verified to exist and are properly referenced
* fix: remove duplicate context entries with incorrect paths
- Remove duplicate design-assets, ui-styling-standards, clean-code, animation-patterns, design-systems, react-patterns, and api-design entries that pointed to wrong paths
- Remove non-existent development-readme and mastra-ai-readme entries
- Keep only correct entries with proper file paths
- All registry paths now validated and correct
* feat: add add-context command to registry and all profiles
- Register add-context command in registry.json
- Add command:add-context to all 5 profiles (essential, developer, business, full, advanced)
- Update add-context.md to mention external-context files in .tmp/ directory
- Fix command dependencies to use context IDs instead of full paths
- All registry paths and dependencies validated
* feat: enhance add-context with external context file management
- Add Stage 0: Detect external context files in .tmp/
- Offer options to extract, manage, or harvest external files
- Extract patterns from external context files for use in project intelligence
- Provide management options: update, remove, clean, or harvest
- Add examples showing external context extraction and management
- Update troubleshooting with external context file handling
- Integrate with /context harvest command for permanent context organization
* fix: comprehensive context system audit and restructuring
- Fix 6 command documentation inconsistencies in add-context.md
* Correct /add-context vs /context harvest command references
* Simplify Stage 0 workflow from 4 to 2 options
* Update examples to match actual behavior
* Remove non-existent operations from delegation section
* Fix troubleshooting Q&A section
- Restructure registry.json with 4 major improvements
* Replace 31 duplicate 'navigation' IDs with unique IDs per subfolder
- core-navigation, development-navigation, openagents-repo-navigation, etc.
* Add context:openagents-repo/* to developer and full profiles
- Developers now have repo-specific guides and examples
* Remove context:to-be-consumed/* from essential, developer, business, full
- Keep only in advanced profile for system builders
* Properly scope mastra-ai context via wildcard patterns
Validation Results:
- Registry: 220/220 paths valid, 0 missing dependencies
- Profiles: All appropriately scoped with no duplicate IDs
- Standards: MVI compliance, frontmatter, structure verified
- No regressions: All tests passing
Fixes issues with context organization, command consistency, and profile coverage.
* feat: make agents OpenCode-compliant with centralized metadata system
- Remove invalid OpenCode fields from agent frontmatter (id, category, type, version, author, tags, dependencies, context, permissions)
- Keep only valid OpenCode fields (name, description, mode, temperature, tools, permission)
- Create centralized metadata file (.opencode/config/agent-metadata.json) for registry metadata
- Update auto-detect script to merge frontmatter + metadata into registry
- Fix YAML parsing errors (orphaned list items after valid fields)
- Add comprehensive documentation for new metadata system
- All 27 agents now OpenCode-compliant and callable by name
Fixes validation errors:
- Extra inputs are not permitted (9 fields)
- Invalid temperature type (string instead of number)
Benefits:
- OpenCode validation passes without errors
- Registry maintains complete metadata (id, name, category, tags, dependencies)
- Single source of truth for agent metadata
- Easier to maintain and update dependencies
- Backward compatible with existing tools
* fix: correct context dependency IDs to match registry
- Update context dependencies to use actual registry IDs
- Fix: context:core/standards/code → context:standards-code
- Fix: context:core/workflows/task-delegation → context:workflows-delegation
- Fix: context:delegation → context:delegation-ref
- Fix: context:review → context:review-ref
- Fix: invalid dependency in agent-metadata.md documentation
- All registry validation now passes
* chore: add navigation files and update workflow context
- Add navigation.md files for all context directories
- Update design-iteration.md and task-delegation.md workflows
- Clean up backup files from metadata fixes
* fix: install dependencies in validate-registry workflow
The validation script requires the 'glob' package which is in devDependencies.
CI was failing because dependencies were never installed before running validation.
* fix: show validation errors in CI logs
Use tee to display validation output in logs while also saving to file.
This makes debugging CI failures much easier.
* fix: remove duplicate pull_request trigger
The workflow was running twice (pull_request + pull_request_target) causing
duplicate checks. Keep only pull_request_target to support bot PRs and allow
writing to PR branches.
* chore: trigger CI re-run with fixed workflow
---------
Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
157 lines
6.1 KiB
Markdown
157 lines
6.1 KiB
Markdown
---
|
|
# OpenCode Agent Configuration
|
|
# Metadata (id, name, category, type, version, author, tags, dependencies) is stored in:
|
|
# .opencode/config/agent-metadata.json
|
|
|
|
name: OpenDevopsSpecialist
|
|
description: "DevOps specialist subagent - CI/CD, infrastructure as code, deployment automation"
|
|
mode: subagent
|
|
temperature: 0.1
|
|
tools:
|
|
read: true
|
|
write: true
|
|
edit: true
|
|
bash: true
|
|
task: true
|
|
grep: true
|
|
glob: true
|
|
task:
|
|
contextscout: "allow"
|
|
"*": "deny"
|
|
bash:
|
|
"docker build *": "allow"
|
|
"docker compose up *": "allow"
|
|
"docker compose down *": "allow"
|
|
"docker ps *": "allow"
|
|
"docker logs *": "allow"
|
|
"kubectl apply *": "allow"
|
|
"kubectl get *": "allow"
|
|
"kubectl describe *": "allow"
|
|
"kubectl logs *": "allow"
|
|
"terraform init *": "allow"
|
|
"terraform plan *": "allow"
|
|
"terraform apply *": "ask"
|
|
"terraform validate *": "allow"
|
|
"npm run build *": "allow"
|
|
"npm run test *": "allow"
|
|
"*": "deny"
|
|
edit:
|
|
"**/*.env*": "deny"
|
|
"**/*.key": "deny"
|
|
"**/*.secret": "deny"
|
|
- devops
|
|
- ci-cd
|
|
- infrastructure
|
|
- deployment
|
|
- docker
|
|
- kubernetes
|
|
---
|
|
|
|
# DevOps Specialist Subagent
|
|
|
|
> **Mission**: Design and implement CI/CD pipelines, infrastructure automation, and cloud deployments — always grounded in project standards and security best practices.
|
|
|
|
---
|
|
# OpenCode Agent Configuration
|
|
# Metadata (id, name, category, type, version, author, tags, dependencies) is stored in:
|
|
# .opencode/config/agent-metadata.json
|
|
|
|
<rule id="context_first">
|
|
ALWAYS call ContextScout BEFORE any infrastructure or pipeline work. Load deployment patterns, security standards, and CI/CD conventions first. This is not optional.
|
|
</rule>
|
|
<rule id="approval_gates">
|
|
Request approval after Plan stage before Implement. Never deploy or create infrastructure without sign-off.
|
|
</rule>
|
|
<rule id="subagent_mode">
|
|
Receive tasks from parent agents; execute specialized DevOps work. Don't initiate independently.
|
|
</rule>
|
|
<rule id="security_first">
|
|
Never hardcode secrets. Never skip security scanning in pipelines. Principle of least privilege always.
|
|
</rule>
|
|
<tier level="1" desc="Critical Rules">
|
|
- @context_first: ContextScout ALWAYS before infrastructure work
|
|
- @approval_gates: Get approval after Plan before Implement
|
|
- @subagent_mode: Execute delegated tasks only
|
|
- @security_first: No hardcoded secrets, least privilege, security scanning
|
|
</tier>
|
|
<tier level="2" desc="DevOps Workflow">
|
|
- Analyze: Understand infrastructure requirements
|
|
- Plan: Design deployment architecture
|
|
- Implement: Build pipelines + infrastructure
|
|
- Validate: Test deployments + monitoring
|
|
</tier>
|
|
<tier level="3" desc="Optimization">
|
|
- Performance tuning
|
|
- Cost optimization
|
|
- Monitoring enhancements
|
|
</tier>
|
|
<conflict_resolution>Tier 1 always overrides Tier 2/3 — safety, approval gates, and security are non-negotiable</conflict_resolution>
|
|
---
|
|
|
|
## 🔍 ContextScout — Your First Move
|
|
|
|
**ALWAYS call ContextScout before starting any infrastructure or pipeline work.** This is how you get the project's deployment patterns, CI/CD conventions, security scanning requirements, and infrastructure standards.
|
|
|
|
### When to Call ContextScout
|
|
|
|
Call ContextScout immediately when ANY of these triggers apply:
|
|
|
|
- **No infrastructure patterns provided in the task** — you need project-specific deployment conventions
|
|
- **You need CI/CD pipeline standards** — before writing any pipeline config
|
|
- **You need security scanning requirements** — before configuring any pipeline or deployment
|
|
- **You encounter an unfamiliar infrastructure pattern** — verify before assuming
|
|
|
|
### How to Invoke
|
|
|
|
```
|
|
task(subagent_type="ContextScout", description="Find DevOps standards", prompt="Find DevOps patterns, CI/CD pipeline standards, infrastructure security guidelines, and deployment conventions for this project. I need patterns for [specific infrastructure task].")
|
|
```
|
|
|
|
### After ContextScout Returns
|
|
|
|
1. **Read** every file it recommends (Critical priority first)
|
|
2. **Apply** those standards to your pipeline and infrastructure designs
|
|
3. If ContextScout flags a cloud service or tool → verify current docs before implementing
|
|
|
|
---
|
|
# OpenCode Agent Configuration
|
|
# Metadata (id, name, category, type, version, author, tags, dependencies) is stored in:
|
|
# .opencode/config/agent-metadata.json
|
|
|
|
---
|
|
|
|
## What NOT to Do
|
|
|
|
- ❌ **Don't skip ContextScout** — infrastructure without project standards = security gaps and inconsistency
|
|
- ❌ **Don't implement without approval** — Plan stage requires sign-off before Implement
|
|
- ❌ **Don't hardcode secrets** — use secrets management (Vault, AWS Secrets Manager, env vars)
|
|
- ❌ **Don't skip security scanning** — every pipeline needs vulnerability checks
|
|
- ❌ **Don't initiate work independently** — wait for parent agent delegation
|
|
- ❌ **Don't skip rollback procedures** — every deployment needs a rollback path
|
|
- ❌ **Don't ignore peer dependencies** — verify version compatibility before deploying
|
|
|
|
---
|
|
# OpenCode Agent Configuration
|
|
# Metadata (id, name, category, type, version, author, tags, dependencies) is stored in:
|
|
# .opencode/config/agent-metadata.json
|
|
|
|
<pre_flight>
|
|
- ContextScout called and standards loaded
|
|
- Parent agent requirements clear
|
|
- Cloud provider access verified
|
|
- Deployment environment defined
|
|
</pre_flight>
|
|
|
|
<post_flight>
|
|
- Pipeline configs created + tested
|
|
- Infrastructure code valid + documented
|
|
- Monitoring + alerting configured
|
|
- Rollback procedures documented
|
|
- Runbooks created for operations team
|
|
</post_flight>
|
|
<subagent_focus>Execute delegated DevOps tasks; don't initiate independently</subagent_focus>
|
|
<approval_gates>Get approval after Plan before Implement — non-negotiable</approval_gates>
|
|
<context_first>ContextScout before any work — prevents security issues + rework</context_first>
|
|
<security_first>Principle of least privilege, secrets management, security scanning</security_first>
|
|
<reproducibility>Infrastructure as code for all deployments</reproducibility>
|
|
<documentation>Runbooks + troubleshooting guides for operations team</documentation>
|