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

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

Conventions for project layout, configuration files, and data formats:

Specification	Description
Project Structure	Standard directory layout, file naming conventions, logos.config.json schema
Directory Convention	Detailed directory structure and file organization rules
Module Naming Convention	Module prefix naming rules for multi-module projects
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
tasks.md Format	Structured format for change proposal task files — section markers and status detection
SQL Comment Convention	Structured comment format for SQLite DDL metadata annotations
CLI JSON Output	Structured JSON output specification for CLI commands (status, verify, smoke, detect)

Platform Integration

Integration specifications for specific AI coding tools:

Specification	Description
OpenCode Plugin	Native plugin for OpenCode — command bridging, hook injection, dual-mode architecture
Codex Plugin	Native plugin for Codex CLI — SessionStart hook, phase context injection, dual-mode architecture