lore

Lore

The story of how this docs repo evolved. Dates derived from git history.

Eras

Sep 2025 — Bootstrap

The repository was created on Sep 10, 2025 with two initial commits: "Initial commit: Documentation foundation" and "Reorganize repository structure" — the entire docs site landed in one go and was immediately re-shuffled into the layout that survives today. The first feature-level addition was MCP documentation (Sep 11, 2025, PR #1: "add mcp docs for cli"), followed by remote workspaces / custom commands.

By the end of September 2025 the repo had ~97 commits. Most of the foundational sections (CLI getting started, configuration, BYOK providers, integrations, enterprise) were established here.

Oct–Dec 2025 — Filling out the platform

This era saw expansion into the surrounding product surface:

• Web/desktop app — docs/web/ getting started, agent readiness, machine connection.
• Cloud templates — the deepest subtree in the docs (docs/web/machine-connection/cloud-templates/).
• Droid Computers — docs/cli/features/droid-computers.mdx and the BYOM variant.
• Enterprise hardening — privacy, identity, SSO/SCIM, network deployment, telemetry export.
• Power-user guides — memory management, prompt crafting, token efficiency, evaluating context compression.

Jan–Feb 2026 — Quiet stretch

Commit volume dipped to 18 (Jan) and 21 (Feb) — the lowest months on record. This corresponds to a period of consolidation rather than new sections.

Mar 2026 — Wiki feature lands

docs/cli/features/wiki/ directory and pages were added (docs: add wiki feature documentation / PR #1045). The Wiki tab now appears in docs.json under the Capabilities group with overview, generate, web-viewer, and auto-refresh sub-pages. This wiki you are currently reading is itself produced by that feature.

Mar–Apr 2026 — Quality push

Recent commits show a documentation-quality theme: "tighten doc openers" (PR #1042), "correct API and CLI references" (PR #1041), "retire stale docs routes" (PR #1040), "clean up public docs quality issues" (PR #1032). The droid-review.yml workflow gives the repo an in-loop reviewer for these passes.

Longest-standing features

These sections trace back to the earliest commits and have survived every reorganization:

Section	First seen	Status
docs/cli/getting-started/	Sep 10, 2025	Still active. Overview, quickstart, common-use-cases, video walkthrough
docs/cli/configuration/	Sep 10, 2025	Still active. Largest config tree in the docs
docs/cli/byok/	Sep 2025	Still active. BYOK providers added incrementally
docs/integrations/	Sep 2025	Still active. GitHub App and IDE integrations
docs/enterprise/	Sep 2025	Still active. Has expanded across multiple sub-areas

Deprecated routes

The repo carries a long list of redirects in docs/docs.json. Each redirect is a fossil of a renamed or removed route. Notable retirements:

• /factory-cli/... paths — early on, the CLI docs lived under factory-cli/. They were moved to cli/... and ~10 redirects preserve incoming links.
• /web/autonomy-maturity/:slug* → /web/agent-readiness/:slug* — the "autonomy maturity" branding was renamed to "agent readiness".
• /reference/maturity-level-reports-api → /reference/readiness-reports-api — same rename, reference side.
• /cli/features/install-github-app → /integrations/github-app — the GitHub App was promoted out of features/ into the dedicated integrations/ section.
• /web/integrations/{linear,slack} → /integrations/{linear,slack} — Linear and Slack integrations consolidated.
• /release-notes/jun-11-factory-1-1, /release-notes/jun-24-factory-1-2 → /changelog/release-notes — earliest release notes were standalone pages and were collapsed into the unified changelog.
• /droids/review_droid/guidelines → /cli/features/code-review#review-guidelines — the review droid had its own URL space before being folded into the CLI features tree.

Major rewrites

There has been one big rename rewrite (autonomy-maturity → agent-readiness) and one structural reshuffle (factory-cli → cli, web/integrations → integrations). Beyond that, the editorial pattern is incremental — pages are added or refined, but the top-level shape established in September 2025 has held.

Growth trajectory

Sep 2025  ████████████████████████████████  97
Oct 2025  ██████████████                    45
Nov 2025  ████████████████████████          77
Dec 2025  ██████████████                    46
Jan 2026  █████                             18
Feb 2026  ██████                            21
Mar 2026  ███████████████████               59
Apr 2026  ██████████████████                57

Steady cadence after the initial bootstrap, with predictable spikes when new product capabilities ship (Mar 2026: wiki feature; ongoing cycles tied to CLI releases and pricing updates).

Localization story

docs/jp/ — the full Japanese mirror — appears very early in the repo's history and is now kept in sync automatically by .github/workflows/sync-jp-docs.yml. The dedicated bulk-translation workflow (translate-jp-docs-bulk.yml) was added for cases where many pages change at once. JP coverage is currently 121 / 125 pages.