opencode-agile-agent 1.0.4 → 1.2.0

package/templates/.opencode/package-lock.json

@@ -0,0 +1,115 @@
+{
+  "name": ".opencode",
+  "lockfileVersion": 3,
+  "requires": true,
+  "packages": {
+    "": {
+      "dependencies": {
+        "@opencode-ai/plugin": "1.4.3"
+      }
+    },
+    "node_modules/@opencode-ai/plugin": {
+      "version": "1.4.3",
+      "resolved": "https://registry.npmjs.org/@opencode-ai/plugin/-/plugin-1.4.3.tgz",
+      "integrity": "sha512-Ob/3tVSIeuMRJBr2O23RtrnC5djRe01Lglx+TwGEmjrH9yDBJ2tftegYLnNEjRoMuzITgq9LD8168p4pzv+U/A==",
+      "license": "MIT",
+      "dependencies": {
+        "@opencode-ai/sdk": "1.4.3",
+        "zod": "4.1.8"
+      },
+      "peerDependencies": {
+        "@opentui/core": ">=0.1.97",
+        "@opentui/solid": ">=0.1.97"
+      },
+      "peerDependenciesMeta": {
+        "@opentui/core": {
+          "optional": true
+        },
+        "@opentui/solid": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/@opencode-ai/sdk": {
+      "version": "1.4.3",
+      "resolved": "https://registry.npmjs.org/@opencode-ai/sdk/-/sdk-1.4.3.tgz",
+      "integrity": "sha512-X0CAVbwoGAjTY2iecpWkx2B+GAa2jSaQKYpJ+xILopeF/OGKZUN15mjqci+L7cEuwLHV5wk3x2TStUOVCa5p0A==",
+      "license": "MIT",
+      "dependencies": {
+        "cross-spawn": "7.0.6"
+      }
+    },
+    "node_modules/cross-spawn": {
+      "version": "7.0.6",
+      "resolved": "https://registry.npmjs.org/cross-spawn/-/cross-spawn-7.0.6.tgz",
+      "integrity": "sha512-uV2QOWP2nWzsy2aMp8aRibhi9dlzF5Hgh5SHaB9OiTGEyDTiJJyx0uy51QXdyWbtAHNua4XJzUKca3OzKUd3vA==",
+      "license": "MIT",
+      "dependencies": {
+        "path-key": "^3.1.0",
+        "shebang-command": "^2.0.0",
+        "which": "^2.0.1"
+      },
+      "engines": {
+        "node": ">= 8"
+      }
+    },
+    "node_modules/isexe": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/isexe/-/isexe-2.0.0.tgz",
+      "integrity": "sha512-RHxMLp9lnKHGHRng9QFhRCMbYAcVpn69smSGcq3f36xjgVVWThj4qqLbTLlq7Ssj8B+fIQ1EuCEGI2lKsyQeIw==",
+      "license": "ISC"
+    },
+    "node_modules/path-key": {
+      "version": "3.1.1",
+      "resolved": "https://registry.npmjs.org/path-key/-/path-key-3.1.1.tgz",
+      "integrity": "sha512-ojmeN0qd+y0jszEtoY48r0Peq5dwMEkIlCOu6Q5f41lfkswXuKtYrhgoTpLnyIcHm24Uhqx+5Tqm2InSwLhE6Q==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/shebang-command": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/shebang-command/-/shebang-command-2.0.0.tgz",
+      "integrity": "sha512-kHxr2zZpYtdmrN1qDjrrX/Z1rR1kG8Dx+gkpK1G4eXmvXswmcE1hTWBWYUzlraYw1/yZp6YuDY77YtvbN0dmDA==",
+      "license": "MIT",
+      "dependencies": {
+        "shebang-regex": "^3.0.0"
+      },
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/shebang-regex": {
+      "version": "3.0.0",
+      "resolved": "https://registry.npmjs.org/shebang-regex/-/shebang-regex-3.0.0.tgz",
+      "integrity": "sha512-7++dFhtcx3353uBaq8DDR4NuxBetBzC7ZQOhmTQInHEd6bSrXdiEyzCvG07Z44UYdLShWUyXt5M/yhz8ekcb1A==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/which": {
+      "version": "2.0.2",
+      "resolved": "https://registry.npmjs.org/which/-/which-2.0.2.tgz",
+      "integrity": "sha512-BLI3Tl1TW3Pvl70l3yq3Y64i+awpwXqsGBYWkkqMtnbXgrMD+yj7rhW0kuEDxzJaYXGjEW5ogapKNMEKNMjibA==",
+      "license": "ISC",
+      "dependencies": {
+        "isexe": "^2.0.0"
+      },
+      "bin": {
+        "node-which": "bin/node-which"
+      },
+      "engines": {
+        "node": ">= 8"
+      }
+    },
+    "node_modules/zod": {
+      "version": "4.1.8",
+      "license": "MIT",
+      "funding": {
+        "url": "https://github.com/sponsors/colinhacks"
+      }
+    }
+  }
+}

package/templates/.opencode/skills/plan-writing/SKILL.md

@@ -20,12 +20,12 @@ Planning is compression: make the next agent's job obvious without wasting conte
 - Capture only the facts that matter for execution.
 
 ## Default Moves
-- Use the compact bundle: proposal.md, goal.md, spec.md, task.md, important.md.
-- proposal = why, value, scope.
-- goal = outcome, constraints, default choice.
-- spec = contracts, flow, edge cases, risks.
+- Use the compact bundle: brief.md, spec.md, task.md, notes.md, status.yaml.
+- brief = why, outcome, scope, constraints, default choice.
+- spec = contract, data flow, edge cases, risks, acceptance criteria.
 - task = ordered checklist and dependencies.
-- important = facts, owners, links, blockers.
+- notes = facts, decisions, blockers, links.
+- status.yaml = live execution state.
 
 ## Anti-Patterns
 - Monolithic tasks, long prose, hidden assumptions, single-point estimates, and unresolved questions with no owner.

package/templates/.opencode/templates/brief.template.md

@@ -0,0 +1,20 @@
+# Brief
+
+## Why
+- 
+
+## Outcome
+- 
+
+## Scope
+- In:
+- Out:
+
+## Constraints
+- 
+
+## Default Choice
+- 
+
+## Non-Goals
+- 

package/templates/.opencode/templates/notes.template.md

@@ -0,0 +1,13 @@
+# Notes
+
+## Facts
+- 
+
+## Decisions
+- 
+
+## Blockers
+- 
+
+## Links
+- 

package/templates/.opencode/templates/spec.template.md

@@ -0,0 +1,17 @@
+# Spec
+
+## Contract
+- Inputs:
+- Outputs:
+
+## Data Flow
+- 
+
+## Edge Cases
+- 
+
+## Risks
+- 
+
+## Acceptance Criteria
+- 

package/templates/.opencode/templates/status.template.yaml

@@ -0,0 +1,14 @@
+feature: <feature-slug>
+owner: <agent-or-person>
+handoff_to: <next-agent-or-person>
+stage: planning
+status: active # allowed: active | blocked | review | done
+review_outcome: <pending-or-result>
+summary: <one-line state>
+done: []
+in_progress: []
+remaining: []
+blockers: []
+last_verification: <command-or-check>
+next_step: <next action>
+updated_at: <ISO-8601>

package/templates/.opencode/templates/task.template.md

@@ -0,0 +1,13 @@
+# Task
+
+1. [ ] Task
+   - Owner:
+   - Depends on:
+
+2. [ ] Task
+   - Owner:
+   - Depends on:
+
+3. [ ] Verify
+   - Owner:
+   - Depends on:

package/templates/AGENTS.template.md

@@ -1,300 +0,0 @@
-# AGENTS.md - [Project Name]
-
-> Instructions for AI agents working on this project.
->
-> How to build lives here; what to build comes from feature specs.
-
----
-
-## Project Stack
-
-<!-- CUSTOMIZE THIS SECTION -->
-
-- Framework: [e.g. React, Vue, Next.js, NestJS, Express]
-- Language: [e.g. TypeScript, JavaScript, Python, Go]
-- State Management: [e.g. Redux, Pinia, Zustand, None]
-- Routing: [e.g. React Router, Vue Router, Next Router]
-- HTTP Client: [e.g. Axios, Fetch, SWR]
-- Build Tool: [e.g. Vite, Webpack, esbuild]
-- Testing: [e.g. Jest, Vitest, Playwright]
-- Styling: [e.g. Tailwind, CSS Modules, Styled Components]
-
----
-
-## Core Documentation
-
-Review these before making architectural or styling decisions:
-
-| Document | Purpose | Location |
-|----------|---------|----------|
-| OpenCode README | Kit overview and flow | `.opencode/README.md` |
-| OpenCode Architecture | Agent lifecycle and gates | `.opencode/ARCHITECTURE.md` |
-| Agent prompts | Role-specific behavior | `.opencode/agents/*.md` |
-| Commands | Custom slash commands | `.opencode/commands/*.md` |
-| Rules | Shared coding standards | `.opencode/rules/*.md` |
-
----
-
-## OpenCode Delivery Model
-
-- Primary agent: `@feature-lead`
-- First call: `@context-gatherer` maps the current project state before planning or proof.
-- Other agents are subagents and are called with `@` awareness.
-- Security-sensitive work: `@security-auditor` first, then `@penetration-tester` for redteam validation when needed.
-- Compact context bundle:
-  - `proposal.md`: why, value, scope
-  - `goal.md`: target outcome, constraints, default choice
-  - `spec.md`: contract, data flow, edge cases, risks
-  - `task.md`: ordered checklist, dependencies, owners
-  - `important.md`: facts, blockers, links, decisions
-- Archive completed bundles in `.opencode/archive/<feature-slug>/`.
-- Default first: choose a safe default when the downside is small.
-- Ask only when scope, security, or architecture changes materially.
-- Keep handoffs compact and explicit.
-
-## Skill Design
-
-- Keep each skill small, philosophy-first, and single-purpose.
-- Put the trigger in the description field so agents can load it by intent.
-- Prefer the smallest skill that answers the next decision.
-
----
-
-## Code Conventions
-
-### File Naming
-
-| Type | Pattern | Example |
-|------|---------|---------|
-| Components | `PascalCase.tsx` | `UserCard.tsx` |
-| Pages | `PascalCasePage.tsx` | `LoginPage.tsx` |
-| Stores | `camelCase.store.ts` | `auth.store.ts` |
-| Hooks/Composables | `useCamelCase.ts` | `useAuth.ts` |
-| Types | `camelCase.types.ts` | `user.types.ts` |
-| Utils | `camelCase.utils.ts` | `date.utils.ts` |
-| API | `camelCase.api.ts` | `auth.api.ts` |
-| Tests | `*.test.ts` or `*.spec.ts` | `auth.test.ts` |
-
-### Code Style
-
-- Indentation: [2 spaces / 4 spaces / tabs]
-- Quotes: [single / double]
-- Semicolons: [required / none]
-- Line Width: [80 / 100 / 120]
-- Trailing Commas: [always / none / es5]
-
----
-
-## Project-Specific Rules
-
-<!-- ADD YOUR CUSTOM RULES HERE -->
-
-- [Add the defaults, tradeoffs, and exceptions for this project]
-- [Call out anything the agents should never do]
-
----
-
-## Architecture Patterns
-
-### State Management
-
-<!-- CUSTOMIZE FOR YOUR STATE SOLUTION -->
-
-- [Describe your store pattern]
-- [Describe where state lives]
-- [Describe how async work is handled]
-
-### API Layer
-
-- [Describe request and response patterns]
-- [Describe how errors are normalized]
-- [Describe versioning or contract rules]
-
-### Component Structure
-
-- [Describe component conventions]
-- [Describe where logic belongs]
-- [Describe how loading and error states appear]
-
----
-
-## Testing Standards
-
-- Unit tests: [what to test]
-- Integration tests: [what to test]
-- E2E tests: [critical flows]
-- Quality gate: [coverage or manual verification target]
-
----
-
-## Quick Reference
-
-- Validate templates: `node bin/validate-templates.js`
-- Sync templates: `node bin/sync-templates.js`
-- Entry point: `@feature-lead`
-
-### Test Coverage
-
-- **Minimum:** 70% coverage
-- **Target:** 80% coverage
-- **Critical paths:** 100% coverage (auth, payments, etc.)
-
----
-
-##  Git Workflow
-
-### Commit Messages
-
-```
-<type>(<scope>): <subject>
-
-<body>
-
-<footer>
-```
-
-**Types:**
-- `feat`: New feature
-- `fix`: Bug fix
-- `refactor`: Code refactor
-- `docs`: Documentation
-- `test`: Tests
-- `chore`: Maintenance
-
-**Example:**
-```
-feat(auth): add JWT refresh token support
-
-- Implement refresh token rotation
-- Add automatic token refresh on 401
-- Store tokens in httpOnly cookies
-
-Closes #123
-```
-
-### Branch Naming
-
-```
-<type>/<ticket>-<short-description>
-
-Examples:
-- feature/AUTH-123-jwt-refresh
-- fix/PAY-456-payment-timeout
-- refactor/CORE-789-state-management
-```
-
----
-
-##  Performance Guidelines
-
-### Do's 
-
-- Lazy load components and routes
-- Memoize expensive computations
-- Paginate large lists
-- Use virtual scrolling for long lists
-- Optimize images and assets
-- Cache API responses when appropriate
-
-### Don'ts 
-
-- Render all items in large lists
-- Call expensive functions in render
-- Watch large objects unnecessarily
-- Block the main thread
-- Make unnecessary API calls
-- Ignore bundle size warnings
-
----
-
-##  Security Guidelines
-
-### Authentication & Authorization
-
-- Never store sensitive data in localStorage
-- Use httpOnly cookies for tokens
-- Implement CSRF protection
-- Validate all user input
-- Sanitize data before rendering
-- Use parameterized queries
-
-### Data Validation
-
-```typescript
-// ✅ Validate at boundaries
-import { z } from 'zod';
-
-const UserSchema = z.object({
-  email: z.string().email(),
-  name: z.string().min(2).max(100),
-  age: z.number().min(0).max(150).optional(),
-});
-
-function createUser(data: unknown): User {
-  return UserSchema.parse(data); // Throws on invalid
-}
-```
-
----
-
-##  Accessibility (a11y)
-
-- Use semantic HTML
-- Provide alt text for images
-- Ensure keyboard navigation
-- Maintain color contrast ratios
-- Use ARIA labels when needed
-- Test with screen readers
-
----
-
-##  Key Reminders
-
-<!-- ADD PROJECT-SPECIFIC REMINDERS -->
-
-1. **[Reminder 1]** - Description
-2. **[Reminder 2]** - Description
-3. **[Reminder 3]** - Description
-
----
-
-##  Quick Reference
-
-### Commands
-
-```bash
-# Development
-npm run dev          # Start dev server
-npm run build        # Production build
-npm run test         # Run tests
-npm run lint         # Lint check
-npm run format       # Format code
-npm run type-check   # TypeScript check
-```
-
-### Important Files
-
-```
-src/
-├── components/      # Reusable components
-├── pages/          # Page components
-├── stores/         # State management
-├── api/            # API calls
-├── types/          # TypeScript types
-├── utils/          # Utility functions
-└── hooks/          # Custom hooks/composables
-```
-
----
-
-##  Questions?
-
-When in doubt:
-1. Check existing code for patterns
-2. Read the relevant docs
-3. Ask the team lead
-4. Follow the principle of least surprise
-
----
-
-**Keep this file updated as the project evolves.**