opencode-configs

Jira issue lifecycle for the build agent. Load this skill when the issue tracker provider is "jira" in agent-config.json. Covers session start, progress tracking, status transitions, and PR linking.

Working with Gitea issues — reading tickets, posting progress updates, and managing dependencies. Load this skill at the start of any session where a Gitea issue number is provided.

GitHub issue lifecycle for the build agent. Load this skill when the issue tracker provider is "github" in agent-config.json. Covers session start, progress tracking, and PR linking.

Git worktree lifecycle for isolated per-ticket workstreams. Load this skill whenever the user describes a problem to solve or asks to claim a ticket, before any implementation work begins.

End-to-end testing conventions using Playwright. Covers writing E2E tests, test execution, project setup, and failure reporting. Load when writing, running, or evaluating E2E tests.

Roadmap management, task logging, and sprint planning conventions for this project. Load when managing ROADMAP.md, writing task logs, or planning a batch of work.

React UI design principles and conventions. Load this skill when building or modifying any user interface. Covers component design, application type detection, Mantine (business apps) and Tailwind (consumer apps), accessibility, responsiveness, and state management patterns.

Observability standards and instrumentation conventions. Load this skill when reviewing code for observability gaps, or when implementing logging, metrics, tracing, or health checks. Covers the four observability signals and stack-specific conventions for each supported language.

Verify that OpenAPI spec files accurately reflect the running API. Covers spec-vs-reality comparison for endpoints, request/response shapes, and status codes. Load when validating that endpoint changes are reflected in the spec.

Language-specific testing best practices. Load this skill when writing or reviewing tests. Covers test structure, factories, mocking boundaries, and framework conventions for TypeScript/JavaScript, Python, and Go.

Deployment strategy and CI/CD pipeline design guidelines. Load this skill when designing deployment workflows, writing CI/CD pipeline configuration, or advising on release strategy. Covers build-once/deploy-anywhere, environment promotion, rollback, and pipeline structure — all provider-agnostic.

Dockerfile authoring guidelines for production-grade, provider-agnostic container images. Load this skill when creating or reviewing any Dockerfile. Covers image selection, multi-stage builds, layer caching, security hardening, and size optimisation.

Kubernetes manifest authoring guidelines. Load this skill when creating or reviewing Kubernetes manifests for any service. Covers when to use Kubernetes, manifest structure, resource limits, health probes, and provider-agnostic conventions.

REST API design principles and conventions. Load this skill when designing or implementing any REST API endpoint, resource, or response shape. Covers resource modelling, naming, versioning, error handling, and security.

JavaScript and TypeScript application structure, tooling, and conventions. Load this skill when starting a new project, adding dependencies, configuring tooling, or making architectural decisions in any JavaScript or TypeScript codebase. Covers pnpm, ESM, strict TypeScript, ESLint, Prettier, and per-application-type conventions for React SPA, Next.js, REST APIs, and CLI tools.

Verify that Swagger UI (or equivalent API documentation interface) is properly served and the raw OpenAPI spec is accessible over HTTP. Load when checking that API documentation is publicly available and functional.

PostgreSQL schema design principles using Prisma. Load this skill when designing or modifying database schemas, writing migrations, or modelling data relationships. Covers naming, normalisation, indexing, constraints, and Prisma-specific conventions.

Test-driven development workflow and discipline. Load this skill before writing any new code or modifying existing behaviour. Covers the red-green-refactor cycle, test design, triangulation, and TDD pitfalls to avoid.