cleveragents/cleveragents-core
4
0
Fork 3
Code Issues 6.0k Pull Requests 115 Actions Packages Projects Releases Wiki Activity

docs(specification): split monolithic spec into docs/specification/ directory #10920

Closed
HAL9000 wants to merge 2 commits from feature/issue-4749-split-monolithic-specification into master
pull from: feature/issue-4749-split-monolithic-specification
merge into: cleveragents:master
Conversation 11 Commits 2 Files Changed 23
+48180 -48112

2 Commits

Author SHA1 Message Date
CleverAgents Bot 90336a5290 ci: stop master workflow on PR updates
CI / lint (pull_request) Has been cancelled
Details
CI / typecheck (pull_request) Has been cancelled
Details
CI / security (pull_request) Has been cancelled
Details
CI / quality (pull_request) Has been cancelled
Details
CI / unit_tests (pull_request) Has been cancelled
Details
CI / integration_tests (pull_request) Has been cancelled
Details
CI / e2e_tests (pull_request) Has been cancelled
Details
CI / coverage (pull_request) Has been cancelled
Details
CI / build (pull_request) Has been cancelled
Details
CI / docker (pull_request) Has been cancelled
Details
CI / helm (pull_request) Has been cancelled
Details
CI / push-validation (pull_request) Has been cancelled
Details
CI / status-check (pull_request) Has been cancelled
Details 
Remove the stale pull_request trigger from master.yml so PR branch commits do not launch the master workflow.

Maintenance patch for PR #10920.
 2026-06-10 20:22:04 -04:00
HAL9000 07175518dc docs(specification): split monolithic spec into docs/specification/ directory
CI / benchmark-publish (pull_request) Has been skipped
Details
CI / lint (pull_request) Successful in 54s
Details
CI / helm (pull_request) Successful in 41s
Details
CI / build (pull_request) Successful in 51s
Details
CI / push-validation (pull_request) Successful in 38s
Details
CI / quality (pull_request) Successful in 1m13s
Details
CI / typecheck (pull_request) Successful in 1m18s
Details
CI / security (pull_request) Successful in 1m33s
Details
CI / benchmark-regression (pull_request) Failing after 52s
Details
CI / e2e_tests (pull_request) Successful in 3m54s
Details
CI / integration_tests (pull_request) Successful in 4m16s
Details
CI / unit_tests (pull_request) Successful in 7m21s
Details
CI / docker (pull_request) Successful in 1m31s
Details
CI / coverage (pull_request) Successful in 18m11s
Details
CI / status-check (pull_request) Successful in 3s
Details 
Split the monolithic docs/specification.md (48,071 lines, ~3.2MB) into a
docs/specification/ directory with 10 logical sub-documents plus an index.

- docs/specification/index.md — Root entry point with navigation table
- docs/specification/overview.md — Overview, standards alignment, and glossary
- docs/specification/cli.md — Complete CLI command reference (~18,000 lines)
- docs/specification/core-concepts.md — Plan lifecycle, actors, tools, skills, resources, context
- docs/specification/behavior.md — Automation profiles, guardrails, plan correction
- docs/specification/tui.md — Text User Interface architecture and components
- docs/specification/configuration.md — Configuration keys and file schemas
- docs/specification/examples.md — End-to-end workflow examples
- docs/specification/architecture.md — System architecture, ACMS, storage, security
- docs/specification/milestones.md — Milestone delivery plan
- docs/specification/acms.md — ACMS v1 detailed specification

docs/specification.md replaced with a stub redirect pointing to docs/specification/index.md.
mkdocs.yml updated with hierarchical navigation for the new sub-documents.
CONTRIBUTING.md, docs/CONTRIBUTING.md, and all .opencode/ agent/skill references updated
to point to docs/specification/ instead of docs/specification.md.

ISSUES CLOSED: #4749
 2026-05-05 15:52:21 +00:00