Small tools. Solid foundations.
A standalone documentation hub for OCode.js and selected Velclaw engineering projects. This repository organizes documentation, design references, source audits, and implementation plans; it does not merge application codebases or automatically write to other repositories.
-
Project overview and architecture: docs/ECOSYSTEM.md
-
OCode.js implementation roadmap: docs/ROADMAP.md
-
Agent Skills Directory: docs/AGENT-SKILLS-DIRECTORY.md — curated skill categories, installation command, platform notes, and safety checklist.
-
Plugin development for ChatGPT and Codex: docs/OPENAI-PLUGIN-DEVELOPMENT.md — plugin architecture, Skills, MCP, authentication, testing, publishing, metadata, UI, and security.
-
x-bo by OCODE.js product/design blueprint: docs/X-BO-BY-OCODEJS-BLUEPRINT.md — target architecture, UX workflow, design system, GitHub/release gates, security, and staged implementation.
-
Source inventory and audit findings: docs/SOURCE-AUDIT.md
-
Content review: docs/CONTENT-REVIEW.md
-
Canonical alignment plan: docs/CANONICAL-ALIGNMENT-PLAN.md
-
OCodeJS brand standardization audit (2026-11-12): docs/BRAND-STANDARDIZATION-2026-11-12.md — repository inventory evidence, product boundaries, first-party candidates, slug migration gates, and execution sequence.
-
Integration contracts and release gates: docs/INTEGRATION-MATRIX.md
-
Phased verification plan: docs/VERIFICATION-PLAN.md
-
Ecosystem development roadmap: docs/ECOSYSTEM-ROADMAP-2026-10.md
-
Infrastructure architecture: docs/INFRASTRUCTURE-ARCHITECTURE.md — service boundaries, hosting, identity, data, delivery and phased expansion.
-
Infrastructure operations: docs/INFRASTRUCTURE-OPERATIONS.md — CI triage, static-site/MCP/Chatbot smoke tests, incident response and recovery gates.
-
Machine-readable service registry: ecosystem/services.json — deployment evidence and verification status for each service.
-
Service registry validator: scripts/validate-services.py — offline schema, URL, duplicate-ID and secret-pattern checks.
-
Repository index and audit checklist: docs/REPOSITORY-INDEX.md
-
Ecosystem audit results: docs/AUDIT-RUN-2026-10-23.md
-
Source-level implementation findings: docs/IMPLEMENTATION-FINDINGS.md
-
Brand/rebrand source document: OCodejs-by-Velclaw-Full-Rebrand.pdf
-
OCode.js logo assets: SVG · Animated logo · Black logo
Repository links are references, not evidence that every source file has been inspected or that a project is production-ready. Product claims must be supported by source code, tests, or an explicit architecture decision.
The documentation site now has a floating assistant launcher and a standalone chatbot.html page. The chatbot runtime remains a separate Next.js application in OCodejs/chatbot; it must be deployed independently on Vercel because GitHub Pages serves static files only.
- Public endpoint configuration: chatbot-config.js — set
window.OCODEJS_CHATBOT_URLto the HTTPS Vercel deployment URL after deployment. - Standalone page: chatbot.html.
- Integration notes and environment checklist: docs/CHATBOT-INTEGRATION.md.
Do not put API keys, database URLs, authentication secrets, or populated .env files in this repository. Configure AUTH_SECRET, POSTGRES_URL, REDIS_URL, and any required Blob/AI Gateway credentials in Vercel Project Settings or the relevant Vercel integrations. The Vercel project creation request for OCodejs/chatbot was blocked by a 403 permission error, so the live endpoint has not yet been verified and the public URL is intentionally unset.
The current priority is to improve this repository itself: navigation, link integrity, mobile usability, accessibility, content accuracy, and repeatable documentation checks. Cross-repository synchronization has been discontinued; this project will not push documentation snapshots into other repositories.
No production deployment, secret migration, or database modification is part of this documentation work.
Make changes on a branch and submit a pull request. Preserve source links, licensing, and attribution. Never commit credentials, populated environment files, or secrets.
- Machine-readable repository inventory: ecosystem/repositories.json
- Inventory validation script: scripts/validate-ecosystem.py
- Implementation roadmap: docs/ROADMAP.md
- Control Center: infra/ — read-only service inventory and browser health checks.
- Integration contracts: docs/INTEGRATION-CONTRACTS.md — API gateway, identity, webhooks and observability standards.
- Control Center guide: docs/CONTROL-CENTER-USER-GUIDE.md — evidence labels, browser health-check semantics and safety boundaries.
- Cloudflare capability snapshot: ecosystem/cloudflare-capabilities.json — read-only inventory; no resources created or modified.
