Skip to content

Documentation Plan

This file documents the planned documentation work and current status.

Current Status: January 10, 2026

✅ Completed

Documentation Site

  • Live at: https://agents-infra-docs.pages.dev (Cloudflare Pages)
  • Dark mode: Default theme
  • Deploy: wrangler pages deploy site --project-name=agents-infra-docs

Wiki Pages (docs/wiki/)

Page Status Description
index.md ✅ Done Homepage with value prop and navigation
quickstart.md ✅ Done 5-minute setup guide
use-cases.md ✅ Done 4 persona scenarios (Sarah, Mike, Lisa, Alex)
faq.md ✅ Done Expandable FAQ sections
executive/overview.md ✅ Done Executive summary
executive/roadmap.md ✅ Done Future capabilities
executive/roi.md ✅ Done ROI calculator with metrics
practitioners/getting-started.md ✅ Done Setup and first workflow
practitioners/windows-setup.md ✅ Done Windows CLI setup (Claude, Gemini, Codex)
practitioners/workflows.md ✅ Done Command catalog
practitioners/best-practices.md ✅ Done Input/output optimization
practitioners/troubleshooting.md ✅ Done Common issues
builders/architecture.md ✅ Done System architecture
builders/plugin-authoring.md ✅ Done Plugin creation guide
builders/skills.md ✅ Done Skills system documentation
builders/mcp.md ✅ Done MCP integration guide
builders/contributing.md ✅ Done Contribution guidelines

Architecture Cleanup

  • ✅ Eliminated "personas" → absorbed into skills
  • ✅ Renamed v3 spec → docs/plugin-architecture.md
  • ✅ Archived v2 docs → archive/docs/
  • ✅ Consolidated constitution → .specify/memory/constitution.md v3.3.0

🔄 In Progress

Plugin README Audit

Plugin Status Notes
core-dependencies ✅ V3 compliant No changes needed
divisions/seo ✅ V3 compliant Production ready
divisions/innovation ✅ V3 compliant Agent building tools
divisions/operations ✅ V3 compliant Wrike time tracking
divisions/analytics ⚪ Empty stub Needs build-out
divisions/pdm 🟡 Has content Needs README
divisions/marketing 🟡 Has content Needs README
infrastructure/mcp-servers ✅ V3 compliant BigQuery, DataForSEO, Wrike

📋 Planned

Year 1 Success Documentation

  • Create executive/year-1-success.md with measurable Definition of Done
  • Add trust guardrails to quality-standards skill
  • Create practitioners/ninjacat.md (NinjaCat integration guide)
  • Create builders/requirements-driven-design.md
  • Create builders/reusable-modules.md
  • Link Executive Tracker CSV as requirements reference (done in year-1-success.md)

Near-term

  • Auto-deploy on git push (Cloudflare Git connection)
  • Create READMEs for pdm and marketing plugins

Future Divisions

  • Analytics division build-out
  • Paid Media division build-out
  • Consider removing empty stub divisions

Architecture Reference

Key Files

File Purpose
.specify/memory/constitution.md Project principles (v3.3.0)
.specify/memory/progress.md Session history for LLM context
docs/plugin-architecture.md Technical architecture spec
AGENTS.md Quick reference for repo
mkdocs.yml Documentation site config

Deployment

# Build and deploy docs
source .venv-mkdocs/bin/activate
mkdocs build
wrangler pages deploy site --project-name=agents-infra-docs --branch=master --commit-dirty=true

MCP Servers

Server Purpose Required By
BigQuery Seer Signals data SEO
DataForSEO SERP/keyword data SEO
Wrike Task management Operations
NinjaCat Analytics aggregation Analytics (planned)