diff --git a/openwiki/.last-update.json b/openwiki/.last-update.json index bf6f423..9a4e70d 100644 --- a/openwiki/.last-update.json +++ b/openwiki/.last-update.json @@ -1,6 +1,6 @@ { - "updated_at": "2026-07-24T10:38:04Z", - "repository": "agentcast", - "updated_by": "openwiki-update-agent", - "notes": "Created initial OpenWiki pages for AGENTS.md and CLAUDE.md OpenWiki entrypoint updates and documentation workflow alignment." + "updatedAt": "2026-07-27T11:20:41.470Z", + "command": "update", + "gitHead": "8e95f2abc64c1f17263d26e480d862962d206ded", + "model": "gpt-5.3-codex-spark" } diff --git a/openwiki/architecture/index.md b/openwiki/architecture/index.md new file mode 100644 index 0000000..d78bc78 --- /dev/null +++ b/openwiki/architecture/index.md @@ -0,0 +1,3 @@ +# Files + +- [OpenWiki Architecture Overview](overview.md) - Explains how AgentCast OpenWiki documentation connects to the repository's source-of-truth contracts and update workflows. diff --git a/openwiki/architecture/overview.md b/openwiki/architecture/overview.md index befea4c..0879666 100644 --- a/openwiki/architecture/overview.md +++ b/openwiki/architecture/overview.md @@ -7,7 +7,7 @@ tags: - architecture - documentation - agentcast -timestamp: "2026-07-24T10:38:04Z" +timestamp: "2026-07-27T11:19:57Z" --- # OpenWiki Architecture Overview @@ -23,9 +23,8 @@ architectural contracts already maintained elsewhere. - [`openwiki/quickstart.md`](../quickstart.md) **links to** [`operations/openwiki-update.md`](../operations/openwiki-update.md) and [`architecture/overview.md`](./overview.md) for deeper detail. - [`/.github/workflows/openwiki-update.yml`](../../.github/workflows/openwiki-update.yml) **orchestrates** scheduled OpenWiki runs. -- [`openwiki/quickstart.md`](../quickstart.md) **reflects** source-of-truth contracts in - [docs/MVP.md](../../docs/MVP.md) and [docs/ARCH.md](../../docs/ARCH.md) via links, - not duplication. +- [`AGENTS.md`](../../AGENTS.md) and [`CLAUDE.md`](../../CLAUDE.md) now state OpenWiki may also point to workflows, domain concepts, integrations, testing guidance, and source maps in addition to architecture and operations. +- [`openwiki/quickstart.md`](../quickstart.md) currently lists those target areas and tracks missing coverage in its backlog, while detailed explanations remain in `docs/` and source code. ## Repository documentation layers @@ -42,6 +41,8 @@ specs, architecture, tests, and principles). This OpenWiki scope is intentionally narrow because recent changes are limited to OpenWiki discoverability and operation messaging in `AGENTS.md` and `CLAUDE.md`. +`openwiki/quickstart.md` now reflects that onboarding sentence while keeping +`openwiki/operations/` as the only fully documented operational surface. The primary relationships to maintain are: @@ -68,6 +69,10 @@ required for this repository. When the code or docs change but OpenWiki structure is unchanged, keep updates small and only where user-facing claims changed. -If the project later adds broader OpenWiki surfaces (for example, a dedicated API -or runtime behavior section), keep the same relationship pattern: one canonical -concept page per area and one or more links from [`openwiki/quickstart.md`](../quickstart.md) (or neighboring core pages). +The architecture page reflects scope drift by linking to `openwiki/quickstart.md` backlog entries for deferred areas (domain concepts, integrations, testing guidance, source maps). + +If the project later adds broader OpenWiki surfaces (for example, a dedicated API, +runtime behavior, domain, integrations, testing, or source-map section), keep the +same relationship pattern: one canonical concept page per area and one or more +links from [`openwiki/quickstart.md`](../quickstart.md) (or neighboring core +pages). diff --git a/openwiki/index.md b/openwiki/index.md new file mode 100644 index 0000000..9e495f0 --- /dev/null +++ b/openwiki/index.md @@ -0,0 +1,12 @@ +--- +okf_version: "0.1" +--- + +# Files + +- [AgentCast OpenWiki Quickstart](quickstart.md) - Canonical entry point for OpenWiki in the AgentCast repository, with links to source-of-truth docs and update workflows. + +# Directories + +- [architecture](architecture/) +- [operations](operations/) diff --git a/openwiki/operations/index.md b/openwiki/operations/index.md new file mode 100644 index 0000000..40d0b21 --- /dev/null +++ b/openwiki/operations/index.md @@ -0,0 +1,3 @@ +# Files + +- [OpenWiki Update Operations](openwiki-update.md) - Operational guide for updating AgentCast OpenWiki after OpenWiki-facing source changes in AGENTS.md, CLAUDE.md, or workflow docs. diff --git a/openwiki/quickstart.md b/openwiki/quickstart.md index dc8c543..0274850 100644 --- a/openwiki/quickstart.md +++ b/openwiki/quickstart.md @@ -7,7 +7,7 @@ tags: - agentcast - documentation - onboarding -timestamp: "2026-07-24T10:38:04Z" +timestamp: "2026-07-27T11:19:57Z" --- # AgentCast OpenWiki Quickstart @@ -23,10 +23,10 @@ Use this as the first page for the repository OpenWiki tree. This repository's OpenWiki pages are a concise index and operations playbook. The long-form contracts and implementation specifics remain in `docs/` and source code; this wiki points to those authoritative sources. -The pages here focus on: +The pages here currently focus on: - where OpenWiki is sourced from in source control, -- which update path to use for scheduled/manual refreshes, +- how scheduled/manual refreshes run, - and what to check before editing documentation pages. ## Source of truth references @@ -53,12 +53,14 @@ Start here, then follow this path when investigating behavior changes: The repository has strict update discipline: refresh only pages whose claims are affected by recent source changes, connector evidence, or explicit task scope. -For this run, the immediate drivers were edits to `AGENTS.md` and `CLAUDE.md`. +For this run, the immediate drivers were edits to `AGENTS.md` and `CLAUDE.md`, which updated the OpenWiki onboarding sentence to enumerate additional conceptual sections. When you inspect this wiki, treat `/openwiki/.last-update.json` as the run marker for the last successful documentation update. ## Backlog -- None at present; if additional OpenWiki source domains are added later (for example, - per-workflow source maps), document them here first and avoid adding thin pages early. +- **Domain concepts** — AGENTS.md/CLAUDE.md OpenWiki onboarding sentence now mentions broader conceptual coverage; full dedicated OpenWiki domain pages are not yet generated, with details still in `docs/` and source code. +- **Integrations surfaces** — AGENTS.md/CLAUDE.md OpenWiki onboarding sentence references integrations, but no dedicated OpenWiki integrations section exists yet. +- **Testing guidance surfaces** — AGENTS.md/CLAUDE.md OpenWiki onboarding sentence references testing guidance, while detailed testing flow is still documented in `docs/TESTING.md`. +- **Source maps** — AGENTS.md/CLAUDE.md OpenWiki onboarding sentence references source maps, but no generated OpenWiki source maps are maintained in this repository yet.