Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 4 additions & 4 deletions openwiki/.last-update.json
Original file line number Diff line number Diff line change
@@ -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"
}
3 changes: 3 additions & 0 deletions openwiki/architecture/index.md
Original file line number Diff line number Diff line change
@@ -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.
19 changes: 12 additions & 7 deletions openwiki/architecture/overview.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ tags:
- architecture
- documentation
- agentcast
timestamp: "2026-07-24T10:38:04Z"
timestamp: "2026-07-27T11:19:57Z"
---

# OpenWiki Architecture Overview
Expand All @@ -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

Expand All @@ -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:

Expand All @@ -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).
12 changes: 12 additions & 0 deletions openwiki/index.md
Original file line number Diff line number Diff line change
@@ -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/)
3 changes: 3 additions & 0 deletions openwiki/operations/index.md
Original file line number Diff line number Diff line change
@@ -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.
14 changes: 8 additions & 6 deletions openwiki/quickstart.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ tags:
- agentcast
- documentation
- onboarding
timestamp: "2026-07-24T10:38:04Z"
timestamp: "2026-07-27T11:19:57Z"
---

# AgentCast OpenWiki Quickstart
Expand All @@ -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
Expand All @@ -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.