diff --git a/.github/workflows/deploy.yml b/.github/workflows/deploy.yml index fe9f5ae..37ecb27 100644 --- a/.github/workflows/deploy.yml +++ b/.github/workflows/deploy.yml @@ -1,7 +1,7 @@ name: Deploy # Build-only strict MkDocs build so a broken vendored page or nav entry -# fails CI instead of deploying. See scripts/vendor-docs.sh and rac-core's +# fails CI instead of deploying. See scripts/vendor-docs.sh and core's # ADR-101 for the vendoring contract. on: diff --git a/.gitignore b/.gitignore index 9deee07..7be6a1e 100644 --- a/.gitignore +++ b/.gitignore @@ -1,6 +1,6 @@ site/ -# Build-time vendored content (see rac-core's ADR-101 — never committed). +# Build-time vendored content (see core's ADR-101 — never committed). .vendor/ -docs/rac-core/* -!docs/rac-core/.gitkeep +docs/core/* +!docs/core/.gitkeep diff --git a/README.md b/README.md index 32897bc..c7970b8 100644 --- a/README.md +++ b/README.md @@ -1,28 +1,28 @@ -# itsthelore.github.io +# AsDecided documentation site -The `itsthelore` org's documentation site, served at -https://itsthelore.github.io/. Built with [MkDocs](https://www.mkdocs.org) -(Material theme) — the same tool and theme `rac-core` already uses for its -own docs, so the org site and every product's docs read as one brand. +The [`asdecided`](https://github.com/asdecided) organization documentation +site, served at https://asdecided.github.io/. It uses the same MkDocs Material +foundation as the native core documentation so every product reads as one +brand. Deployed by GitHub Actions on every push to `main`. ## How content gets here -Sections under `/rac-core/` (and future product sections) are **vendored, +Sections under `/core/` (and future product sections) are **vendored, not authored here**: `scripts/vendor-docs.sh` sparse-checks out each source repo's `docs/` directory into `docs//` before `mkdocs build`. Nothing -vendored is committed — `docs/rac-core/` is gitignored. Because it lands in +vendored is committed — `docs/core/` is gitignored. Because it lands in the same MkDocs `docs_dir` as everything else, the source repos' existing relative links between pages (`[relationships.md](relationships.md)`, `cli.md#schema`, etc.) resolve correctly with no rewriting. -The rationale and contract are recorded in `rac-core`'s -[ADR-101](https://github.com/itsthelore/rac-core/blob/main/rac/decisions/adr-101-org-docs-site-and-topology.md). +The rationale and contract are recorded in core's +[ADR-101](https://github.com/asdecided/core/blob/main/decisions/decisions/adr-101-org-docs-site-and-topology.md). The site's own visual identity (light theme, Inter for prose, JetBrains -Mono for code, the lamplighter at icon size only) is recorded in `rac-core`'s -[ADR-102](https://github.com/itsthelore/rac-core/blob/main/rac/decisions/adr-102-org-site-brand-direction.md): -it deliberately *rhymes with, but does not match*, `rac-core`'s +Mono for code, the lamplighter at icon size only) is recorded in core's +[ADR-102](https://github.com/asdecided/core/blob/main/decisions/decisions/adr-102-org-site-brand-direction.md): +it deliberately *rhymes with, but does not match*, core's `rac-localview` product-UI theme (dark, mono-everywhere) — three shared constants (the amber accent, mono-for-code, the lamplighter), everything else per surface. Brand assets (`docs/fonts/`, @@ -37,13 +37,13 @@ Adding a new product section: 3. Add a card to "The ecosystem" grid in `docs/index.md`. **The homepage hero is temporarily spec-led** (headline, CTAs, and eyebrow -all point at the rac-spec announcement essay, per an explicit "for now" +all point at the specification announcement essay, per an explicit "for now" request) instead of the previous product pitch — see the comment at the top of `overrides/home.html` for what to restore and why. ## Org-wide star count -The hero shows a "★ N stars across itsthelore's open-source repos" line, +The hero shows a "★ N stars across AsDecided's open-source repos" line, sourced by `scripts/fetch-org-stats.sh` (sums `stargazers_count` across the org's public repos via the GitHub API) and exposed to `overrides/home.html` through `mkdocs.yml`'s `extra.total_org_stars` (an `!ENV` tag reading the @@ -57,7 +57,7 @@ hero hides the line entirely. `docs/essays.md` (nav label "Essays") is a **hand-curated index**, not an auto-generated blog. An essay lives wherever it makes most sense — a spec announcement lives inside the relevant section (e.g. -`docs/rac-spec/why-strict.md`) rather than a generic `/blog/` — and gets one +`docs/spec/why-strict.md`) rather than a generic `/blog/` — and gets one card added to `docs/essays.md` linking to it. This is deliberate: essays don't all belong under one directory, so there's nothing for a plugin to auto-discover. @@ -85,7 +85,7 @@ override — to add `og:*` and `twitter:*` meta tags to every page via brand or tagline changes. - Add a `description:` to a page's frontmatter for a tailored social preview instead of the generic site description (see - `docs/rac-spec/why-strict.md` for an example). + `docs/spec/why-strict.md` for an example). ## Local development diff --git a/docs/core/.gitkeep b/docs/core/.gitkeep new file mode 100644 index 0000000..8b13789 --- /dev/null +++ b/docs/core/.gitkeep @@ -0,0 +1 @@ + diff --git a/docs/essays.md b/docs/essays.md index 88dc152..f85b745 100644 --- a/docs/essays.md +++ b/docs/essays.md @@ -1,14 +1,14 @@ # Essays -Longer-form writing from the itsthelore team — on requirements-as-code, +Longer-form writing from the asdecided team — on requirements-as-code, agent-grounded knowledge, and the RAC specification. An essay lives wherever it makes most sense (a spec announcement lives with the spec's own section; others may not), and is indexed here regardless.
-

rac-spec · 2026

-

Requirements as Code: a strict semantic layer over OKF

+

AsDecided Spec · 2026

+

Requirements as Code: a strict semantic layer over OKF

Why RAC specifies a strict, enforced semantic layer for prescriptive knowledge on top of OKF's deliberately permissive carrier.

diff --git a/docs/index.md b/docs/index.md index a742881..040c884 100644 --- a/docs/index.md +++ b/docs/index.md @@ -5,12 +5,12 @@ hide: - toc --- -RAC is the engine underneath: **Lore** keeps a team's recorded +**AsDecided** keeps a team's recorded requirements, decisions, and designs as typed Markdown in the repo, validates them in CI, and serves them read-only to coding agents over MCP. ``` -pip install rac-core +brew install asdecided/tap/asdecided-core ``` ## How it works @@ -23,7 +23,7 @@ pip install rac-core

CI rejects malformed artifacts, broken links, and references to superseded decisions before they land.

03

Serve

-

Your agent queries Lore over MCP — four read-only tools — and cites +

Your agent queries AsDecided over MCP and cites decisions by ID instead of violating them.

@@ -31,8 +31,8 @@ pip install rac-core > Lore, finds your soft-delete decision, cites it by ID, and proposes the > compliant change instead of reintroducing what you removed on purpose. -Serving happens over the [lore MCP server](rac-core/mcp.md); the -[`rac` CLI](rac-core/cli.md) covers validation, inspection, and ingestion. +Serving happens over the [AsDecided MCP server](core/mcp.md); the +[`decided` CLI](core/cli.md) covers validation and inspection. ## Why it's different @@ -54,8 +54,8 @@ Serving happens over the [lore MCP server](rac-core/mcp.md); the ## The ecosystem
-

Lore (rac-core)

-

The engine: the rac CLI, validation gates, and the read-only lore MCP +

Core

+

The native Rust engine: the decided CLI, validation gates, and the read-only MCP server. This is what you install.

Proofkeeper

Turns each recorded capability into a re-runnable Playwright test, @@ -63,32 +63,31 @@ Serving happens over the [lore MCP server](rac-core/mcp.md); the

Wayfinder

Deterministic prompt-complexity routing — a hard-or-easy call on every prompt, offline, no model call.

-

rac-sdk

+

SDK

Non-Python language SDKs — thin clients over the engine's stable --json contracts.

-

rac-editors

+

Editors

IDE and editor integrations, one subdir per client.

-

rac-ci

+

CI

The CI delivery surface — validation and gating wrappers, GitHub first.

-

rac-benchmarks

+

Benchmarks

Evaluation suites, one subdir per benchmark.

-Plus rac-connectors and everything else — see the -[full repository map](rac-core/ecosystem.md) or the -[itsthelore org on GitHub](https://github.com/itsthelore). +Plus connectors and everything else — see the +[full repository map](core/ecosystem.md) or the +[AsDecided organization on GitHub](https://github.com/asdecided). -

Lore is built on RAC (requirements-as-code), the -open-source engine — pip install rac-core installs the CLI and -the lore MCP server together.

+

RAC remains the stable artifact contract underneath. +asdecided-core installs the native CLI and MCP server together.

Up and running in five minutes.

Install the CLI, scaffold your first artifact, connect your agent.

-

Lore is open source and under active development.

+

AsDecided is open source and under active development.

diff --git a/docs/rac-core/.gitkeep b/docs/rac-core/.gitkeep deleted file mode 100644 index e69de29..0000000 diff --git a/docs/rac-spec/why-strict.md b/docs/spec/why-strict.md similarity index 94% rename from docs/rac-spec/why-strict.md rename to docs/spec/why-strict.md index 8d41aa9..98e09db 100644 --- a/docs/rac-spec/why-strict.md +++ b/docs/spec/why-strict.md @@ -46,12 +46,12 @@ superseded architecture decision re-introduces the exact mistake your team already paid to rule out. The failure mode isn't degraded output; it's confident regression, delivered with a citation. -## What rac-spec specifies +## What the AsDecided specification specifies RAC (Requirements as Code) is the semantic layer for prescriptive knowledge — requirements, decisions, designs — written on the same carrier -OKF standardizes. Today we're publishing rac-spec, the specification, as its -own versioned document, separate from rac-core, the reference implementation +OKF standardizes. Today we're publishing the RAC specification as its own +versioned document, separate from AsDecided Core, the reference implementation that has been dogfooding it across 29 releases. The spec formalizes four things the carrier layer leaves open: @@ -125,7 +125,7 @@ our Python. If you're running agents against team knowledge and you've hit the confident-regression failure, the spec is at -[github.com/itsthelore/rac-spec](https://github.com/itsthelore/rac-spec/blob/main/SPEC.md), -the reference implementation is `pip install rac-core`, and the fastest way +[github.com/asdecided/spec](https://github.com/asdecided/spec/blob/main/SPEC.md), +the reference implementation is `brew install asdecided/tap/asdecided-core`, and the fastest way to form an opinion is to run `rac validate` against the examples directory and read what it rejects and why. diff --git a/docs/stylesheets/extra.css b/docs/stylesheets/extra.css index 0e18c89..c935590 100644 --- a/docs/stylesheets/extra.css +++ b/docs/stylesheets/extra.css @@ -428,7 +428,7 @@ body, display: none; } -/* ---- docs polish (applies passively to vendored rac-core pages) ------- */ +/* ---- docs polish (applies passively to vendored core pages) ----------- */ .md-typeset code { background: var(--lore-bg-element); border-radius: 4px; diff --git a/mkdocs.yml b/mkdocs.yml index 5c3eba5..657135a 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -1,10 +1,10 @@ -site_name: Lore +site_name: AsDecided site_description: >- - Requirements-as-code for AI-assisted product teams — the itsthelore - organisation's documentation site. -site_url: https://itsthelore.github.io/ -repo_url: https://github.com/itsthelore -repo_name: itsthelore + Engineering decisions your agents can follow — the AsDecided documentation + site. +site_url: https://asdecided.github.io/ +repo_url: https://github.com/asdecided +repo_name: asdecided theme: name: material @@ -24,7 +24,7 @@ theme: extra_css: - stylesheets/extra.css -copyright: "© 2026 itsthelore" +copyright: "© 2026 AsDecided" extra: # Set by scripts/fetch-org-stats.sh via the TOTAL_ORG_STARS env var @@ -33,15 +33,15 @@ extra: total_org_stars: !ENV [TOTAL_ORG_STARS, 0] social: - icon: fontawesome/brands/github - link: https://github.com/itsthelore + link: https://github.com/asdecided plugins: - search -# rac-core/integration-recipes.md deliberately links to examples/ outside +# core/integration-recipes.md deliberately links to examples/ outside # docs_dir (rendered by GitHub, not this site) — not a broken link, just one # MkDocs can't resolve locally. Downgraded so --strict doesn't abort on -# vendored content we don't author. rac-core's own docs.yml build has the +# vendored content we don't author. Core's own docs.yml build has the # same warning and is not currently strict-clean for it either. validation: links: @@ -51,24 +51,24 @@ nav: - Home: index.md - Essays: essays.md - Get started: - - Overview: rac-core/index.md - - Quickstart: rac-core/quickstart.md - - Connect your agent: rac-core/mcp.md + - Overview: core/index.md + - Quickstart: core/quickstart.md + - Connect your agent: core/mcp.md - Guides: - - Shared Server: rac-core/shared-server.md - - Context Cost: rac-core/context-cost.md - - Watchkeeper: rac-core/watchkeeper.md - - Repository Workflow: rac-core/repo-workflow.md - - Examples: rac-core/examples.md + - Shared Server: core/shared-server.md + - Context Cost: core/context-cost.md + - Watchkeeper: core/watchkeeper.md + - Repository Workflow: core/repo-workflow.md + - Examples: core/examples.md - Reference: - - CLI Reference: rac-core/cli.md - - Artifacts: rac-core/artifacts.md - - Relationships: rac-core/relationships.md - - Validation: rac-core/validation.md + - CLI Reference: core/cli.md + - Artifacts: core/artifacts.md + - Relationships: core/relationships.md + - Validation: core/validation.md - Operate: - - Governance: rac-core/governance.md - - Security: rac-core/security.md - - OKF Profile: rac-core/okf-profile.md + - Governance: core/governance.md + - Security: core/security.md + - OKF Profile: core/okf-profile.md - Project: - - Ecosystem: rac-core/ecosystem.md - - Testing & Contributing: rac-core/testing.md + - Ecosystem: core/ecosystem.md + - Testing & Contributing: core/testing.md diff --git a/overrides/home.html b/overrides/home.html index 9f8568a..0eba058 100644 --- a/overrides/home.html +++ b/overrides/home.html @@ -7,7 +7,7 @@ docs/index.md and render through {{ page.content }} so they remain plain Markdown. - TEMPORARY: hero leads with the rac-spec announcement essay rather than + TEMPORARY: hero leads with the specification announcement essay rather than the product pitch, at the maintainer's explicit request ("for now"). The install command moved out of the hero into "How it works" in docs/index.md; revert to the product-led hero (git history has it) once @@ -26,14 +26,14 @@

A strict semantic layer over OKF.

{% if config.extra.total_org_stars and config.extra.total_org_stars | int > 0 %}

- ★ {{ config.extra.total_org_stars }} stars across itsthelore's open-source repos + ★ {{ config.extra.total_org_stars }} stars across AsDecided's open-source repos

{% endif %}
diff --git a/scripts/fetch-org-stats.sh b/scripts/fetch-org-stats.sh index 030044d..585eb98 100755 --- a/scripts/fetch-org-stats.sh +++ b/scripts/fetch-org-stats.sh @@ -1,12 +1,12 @@ #!/usr/bin/env bash -# Sums stargazers_count across every public repo in the itsthelore org and +# Sums stargazers_count across every public repo in the AsDecided org and # exposes it to mkdocs.yml's `extra.total_org_stars` via the TOTAL_ORG_STARS # env var (mkdocs.yml reads it with the !ENV tag, default 0). In GitHub # Actions, GITHUB_TOKEN gives a real count; without a token (local dev) # this is skipped and the site falls back to hiding the stat entirely. set -euo pipefail -ORG=itsthelore +ORG=asdecided if [ -z "${GITHUB_TOKEN:-}" ]; then echo "GITHUB_TOKEN not set — skipping live star fetch (site will hide the stat)." >&2 @@ -22,7 +22,7 @@ token = os.environ["GITHUB_TOKEN"] headers = { "Authorization": f"Bearer {token}", "Accept": "application/vnd.github+json", - "User-Agent": "itsthelore-site-build", + "User-Agent": "asdecided-site-build", } total = 0 diff --git a/scripts/vendor-docs.sh b/scripts/vendor-docs.sh index 577593f..ed5687c 100755 --- a/scripts/vendor-docs.sh +++ b/scripts/vendor-docs.sh @@ -1,5 +1,5 @@ #!/usr/bin/env bash -# Implements the vendor contract from rac-core's ADR-101: sparse-checkout +# Implements the vendor contract from core's ADR-101: sparse-checkout # each source repo's docs/ at build time, never commit the result. set -euo pipefail @@ -27,12 +27,12 @@ vendor_repo() { cp -r "$checkout_dir/$path/." "$target_dir/" } -vendor_repo rac-core https://github.com/itsthelore/rac-core.git main docs +vendor_repo core https://github.com/asdecided/core.git main docs # The org root (docs/index.md) already carries its own splash hero; strip -# the vendored rac-core home's template/hide frontmatter so it renders as a +# the vendored core home's template/hide frontmatter so it renders as a # normal nav page ("Overview") instead of a second, mislinked splash. -python3 - "$docs_dir/rac-core/index.md" <<'PYEOF' +python3 - "$docs_dir/core/index.md" <<'PYEOF' import re, sys path = sys.argv[1]