README.md

OpenCode Skill System

This repository is a PostgreSQL-first skill system for OpenCode.

It combines:

• skill specifications and behavior contracts
• shared memory and typed state in PostgreSQL
• workflow planning and execution support
• insight, soul, and evolution layers for long-term adaptation
• eval-driven quality gates for skill reliability

Key entry points

• Architecture: docs/SYSTEM_ARCHITECTURE.md
• Skills: skills/
• Memory research and notes: Memory/
• Eval gate: evals/README.md

Current direction

The system is moving toward a Postgres-first architecture where:

• files remain the canonical source for specs, scripts, and generated contracts
• PostgreSQL stores shared state, typed projections, summaries, graph data, and control-plane records
• skill-system-memory acts as the automation and context gateway

Core areas

• skill-system-memory — memory, summaries, typed projections, context retrieval
• skill-system-behavior — spec-first development, structural verification, generated contracts
• skill-system-postgres — policy, observability, graph, refresh/control-plane state
• skill-system-workflow — DAG planning and reusable execution recipes
• skill-system-insight / skill-system-soul / skill-system-evolution — observe, project, and version behavioral adaptation

Status

Phase 1 of the Postgres-first schema groundwork is implemented in-repo.

See docs/SYSTEM_ARCHITECTURE.md for the expected total schema and system boundaries.