Ryanhecht Octopal Wiki Updater

Wiki Updater

You update the Octopal GitHub wiki based on code changes. The wiki lives in the wiki/ directory at the repository root (a separate git clone of the GitHub wiki repo).

When This Skill Activates

Use this skill when the user asks you to update the wiki, sync documentation, or review whether the wiki needs updates based on code changes.

Wiki Pages

The wiki consists of these pages (all in wiki/):

How to Analyze Changes

Depending on what the user asks, use these approaches:

Uncommitted Changes

git diff                    # Unstaged changes
git diff --cached           # Staged changes
git diff HEAD               # All uncommitted changes (staged + unstaged)

Specific Commit

git show <commit-sha>       # Full diff of a single commit
git log --oneline -1 <sha>  # Commit message

Pull Request / Branch Diff

git diff main...<branch>    # Changes introduced by a branch
git log --oneline main...<branch>  # Commits in the branch

Changes Since a Commit

git diff <commit-sha>..HEAD           # Diff from commit to current HEAD
git log --oneline <commit-sha>..HEAD  # All commits since that point

Recent Changes (by time)

git log --oneline --since="1 week ago"
git diff HEAD~10..HEAD      # Last 10 commits

Workflow

1. Gather the diff — Use the appropriate git command based on the user's request

2. Identify affected wiki pages — Map changed files to relevant wiki pages:

   Changed files	Wiki pages to check
   packages/core/src/tools.ts	Agent-Tools.md
   packages/core/src/agent.ts	Architecture.md
   packages/core/src/vault.ts	Architecture.md
   packages/core/src/para.ts	PARA-Method.md, Architecture.md
   packages/core/src/tasks.ts	PARA-Method.md
   packages/core/src/config.ts	Configuration.md
   packages/core/src/auth.ts	Daemon-and-API.md
   packages/core/src/preprocessor.ts	Knowledge-Base.md
   packages/core/src/knowledge.ts	Knowledge-Base.md
   packages/core/src/scheduler.ts	Scheduler.md
   packages/core/src/schedule-types.ts	Scheduler.md
   packages/core/src/prompts.ts	Architecture.md
   packages/core/src/connector.ts	Connectors.md
   packages/cli/src/index.ts	CLI-Reference.md, Getting-Started.md
   packages/cli/src/setup.ts	Getting-Started.md
   packages/cli/src/skills.ts	Skills-System.md, CLI-Reference.md
   packages/cli/src/client.ts	Architecture.md
   packages/server/src/server.ts	Daemon-and-API.md, Architecture.md
   packages/server/src/protocol.ts	Daemon-and-API.md
   packages/server/src/ws.ts	Daemon-and-API.md
   packages/server/src/sessions.ts	Daemon-and-API.md
   packages/server/src/routes/*.ts	Daemon-and-API.md
   packages/connector-discord/**	Connectors.md
   packages/connector/**	Connectors.md
   builtin-skills/**	Skills-System.md
   package.json	Getting-Started.md, Architecture.md
   ARCHITECTURE.md	(pointer file — no content to sync)
   README.md	Home.md, Getting-Started.md

3. Read the current wiki page — Read the relevant wiki page(s)

4. Read the changed source files — Understand the new behavior

5. Update the wiki — Make surgical edits to reflect the changes:

   • Add documentation for new tools, commands, config options, or features
   • Update changed parameters, behaviors, or defaults
   • Remove documentation for deleted features
   • Keep the existing style and structure

6. Commit and push the wiki — From the wiki/ directory:

   cd wiki && git add -A && git commit -m "Update wiki: <summary>" && git push
   

Guidelines

• Be surgical — Only update sections that are actually affected by the changes
• Preserve style — Match the existing formatting, table structure, and heading hierarchy
• Don't over-document — Internal implementation details don't need wiki coverage; focus on user-facing behavior and developer-facing APIs
• Update the sidebar — If you add a new page, add it to _Sidebar.md
• Update Home.md — If you add a new page, add it to the quick links table
• Check cross-references — If you rename or restructure a page, update [[links]] in other pages

Converted and distributed by TomeVault — claim your Tome and manage your conversions.