# AGENTS.md - OpenCode Integration

This file provides project-specific guidance for OpenCode's AI coding agent.

<!-- AIWG SDLC Framework Integration -->

{{REMOTES_TOPOLOGY}}
## AIWG SDLC Framework

This project uses the AIWG SDLC Framework for software development lifecycle management.

### Available Skills

AIWG skills are deployed to `.opencode/skill/` and are automatically available as commands in OpenCode:

- `project-status` - Current project status and next steps
- `flow-gate-check` - Validate phase gate criteria
- `security-gate` - Run security validation
- `generate-tests` - Generate test suite

Skills double as OpenCode commands — no separate command files needed.

### AIWG Agents via MCP

AIWG specialized agents are available as MCP tools when `aiwg mcp serve` is running (configured via `opencode.json`). Define custom agents in `opencode.json` under the `agent` key.

### SDLC Artifacts Location

All SDLC artifacts are stored in `.aiwg/`:

```
.aiwg/
├── intake/        # Project intake forms
├── requirements/  # User stories, use cases
├── architecture/  # SAD, ADRs
├── planning/      # Phase plans
├── risks/         # Risk register
├── testing/       # Test strategy
├── security/      # Threat models
├── deployment/    # Deployment plans
├── working/       # Temporary (safe to delete)
└── reports/       # Generated reports
```

### Workflow Patterns

**Multi-agent review**: For comprehensive artifact review, invoke multiple agents in parallel using the `aiwg-orchestrator` tool.

**Phase transitions**: Use `/flow-inception-to-elaboration`, `/flow-elaboration-to-construction`, etc. for guided phase transitions.

**Continuous validation**: Use `/flow-security-review-cycle`, `/flow-test-strategy-execution` for ongoing quality assurance.

## Project-Specific Configuration

<!-- Add project-specific instructions below this line -->