Specifications Overview
OpenLogos specifications are the authoritative rules that all Skills, CLI commands, and AI instruction files follow. They define the development workflow, project structure, file formats, and platform integration mechanisms.
Specifications are grouped into three categories:
Methodology
Section titled “Methodology”Core rules that govern how OpenLogos projects progress:
| Specification | Description |
|---|---|
| Workflow | Three-layer progression model (WHY → WHAT → HOW), scenario threading, phase detection, quality gates |
| Change Management | Delta change proposals, impact analysis, merge workflow, and archival |
File Formats & Structure
Section titled “File Formats & Structure”Conventions for project layout, configuration files, and data formats:
| Specification | Description |
|---|---|
| Project Structure | Standard directory layout, file naming conventions, logos.config.json schema |
| logos-project.yaml | AI collaboration index file — schema, field definitions, and examples |
| AGENTS.md | AI instruction file — content structure, generation rules, multi-platform adaptation |
| Test Results Format | JSONL format for cross-framework test result reporting, reporter code templates |
Platform Integration
Section titled “Platform Integration”Integration specifications for specific AI coding tools:
| Specification | Description |
|---|---|
| OpenCode Plugin | Native plugin for OpenCode — command bridging, hook injection, dual-mode architecture |