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
Flow Specification	Orchestratable development-flow data model: subflows, nodes, gates, loops, overlays
Slice Planner	How [code] slices are planned after merge
PreToolUse Guard	Write guard: what is protected (version-controlled content), pre-checks, post-execution checks, and protection-scope commands

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
TEST_SLICE_MANIFEST	Machine-readable [code] slice manifest written by openlogos slice plan and read by verify
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
Cursor Plugin	Cursor integration: native Skills in .cursor/skills/, managed .cursor/hooks.json entries, partial-strength guard with afterShellExecution post-check
ZCode Plugin	Native ZCode plugin in .zcode/plugins/openlogos/: Skills, commands, agents, SessionStart and PreToolUse hooks
Qoder Plugin	Native Qoder CLI plugin in .qoder/plugins/openlogos/: Skills, commands, agents, SessionStart and PreToolUse hooks
WorkBuddy Plugin	Native WorkBuddy plugin in .workbuddy/plugins/openlogos/: Skills, commands, agents, SessionStart and PreToolUse hooks; native memory left untouched