Add agentic-wiki-writer and agentic-wiki-coder workflows by mrjf · Pull Request #210 · githubnext/agentics

mrjf · 2026-02-27T00:27:25Z

Summary

Adds agentic-wiki-writer: generates GitHub wiki pages from source code using a PAGES.md template, with incremental regeneration via repo memory
Adds agentic-wiki-coder: the reverse — detects wiki edits describing new/changed functionality, implements code changes, runs tests, and opens a PR
Pre-creates .github/agentic-wiki/ directory outside sandbox (mkdir in bash allowlist doesn't work reliably)
Loosens mermaid diagram prompting so the agent actually generates diagrams for architecture/flow pages

Test plan

Tested agentic-wiki-writer on githubnext/w3k via gh aw add-wizard githubnext/agentics/agentic-wiki-writer@wiki-workflows
Verify docs and README entries are auto-generated by daily-repo-goals after merge

🤖 Generated with Claude Code

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

mkdir inside the sandbox bash allowlist doesn't work reliably. Move directory creation to a pre-step that runs before the agent. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

The previous prompting was too conservative, causing the agent to almost never generate diagrams even for architecture/flow pages. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Copilot

Pull request overview

Adds two new agentic workflow prompt definitions intended to keep a repository’s GitHub wiki and source code in sync via automated wiki generation and wiki-driven implementation.

Changes:

Add Agentic Wiki Writer workflow to generate wiki pages from a .github/agentic-wiki/PAGES.md template with incremental regeneration via repo-memory.
Add Agentic Wiki Coder workflow to react to wiki edits (gollum), implement corresponding code changes, run tests, and open a PR.

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 8 comments.

File	Description
workflows/agentic-wiki-writer.md	New workflow prompt for generating wiki pages from source code and a PAGES.md template (includes incremental memory design and intended wiki push).
workflows/agentic-wiki-coder.md	New workflow prompt for turning wiki edits into code changes + tests + PRs (includes pre-staging event payload and pre-cloning the wiki).

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Copilot · 2026-02-27T00:34:20Z

workflows/agentic-wiki-writer.md

+---
+name: Agentic Wiki Writer
+description: >
+  Generates GitHub wiki pages from source code using a PAGES.md template.
+  Runs on PR merge or manual dispatch with agent-driven triage.
+on:


Repo convention: every workflows/*.md entry should have a matching docs/*.md page and a README entry (enforced by the Daily Repo Goal Achiever). This PR adds the workflow but not its docs/README counterparts, so it will immediately be flagged by automation after merge—please add docs/agentic-wiki-writer.md and update README.md in this PR.

I'll leave it to the agentic workflow 😉

Copilot · 2026-02-27T00:34:20Z

workflows/agentic-wiki-coder.md

+---
+name: Agentic Wiki Coder
+description: >
+  Analyzes wiki edits for new or changed functionality, implements code changes,
+  runs tests, and creates a PR. The reverse of agentic-wiki-writer.
+on: gollum


Repo convention: every workflows/*.md entry should have a matching docs/*.md page and a README entry (enforced by the Daily Repo Goal Achiever). This PR adds the workflow but not its docs/README counterparts, so it will immediately be flagged by automation after merge—please add docs/agentic-wiki-coder.md and update README.md in this PR.

Copilot · 2026-02-27T00:34:21Z

workflows/agentic-wiki-coder.md

+---
+name: Agentic Wiki Coder
+description: >
+  Analyzes wiki edits for new or changed functionality, implements code changes,
+  runs tests, and creates a PR. The reverse of agentic-wiki-writer.
+on: gollum
+permissions:
+  contents: read
+tools:
+  bash: true
+  edit:
+  write: true
+  github:
+    toolsets: [repos]
+  repo-memory:
+    branch-name: memory/wiki-to-code
+    description: "Wiki-to-source mappings, processed edit SHAs, and implementation notes"
+    allowed-extensions: [".json", ".md"]
+    max-file-size: 1048576
+    max-file-count: 50


The agent prompt requires running dependency installs and tests (e.g., bun install, bun test, bunx tsc), but the workflow doesn’t declare any network: allowance. In this repo, workflows that run package managers typically set network: defaults (and/or node) so the sandbox can reach registries—without it, these steps are likely to fail at runtime.

True, but given that wikis can be world-editable (this is not the default), I'd like to keep this constrained by default. Maintainers can give increased permissions if they're comfortable doing so.

workflows/agentic-wiki-writer.md

Copilot · 2026-02-27T00:34:21Z

workflows/agentic-wiki-writer.md

+  create-pull-request:
+    title-prefix: "[agentic-wiki]"
+    labels: [documentation, automated]
+  jobs:
+    push-wiki:
+      description: >
+        Push generated wiki pages to the repository wiki.
+        Pass a JSON object mapping filenames to markdown content.
+      runs-on: ubuntu-latest
+      output: "Wiki pages pushed successfully"
+      permissions:
+        contents: write
+      inputs:
+        files:
+          description: "JSON object mapping filenames to markdown content, e.g. {\"Home.md\": \"...\", \"_Sidebar.md\": \"...\"}"
+          required: true
+          type: string
+      steps:
+        - name: Checkout wiki
+          uses: actions/checkout@v4
+          with:
+            repository: ${{ github.repository }}.wiki
+            token: ${{ secrets.GITHUB_TOKEN }}
+        - name: Write wiki pages
+          run: |
+            FILES=$(jq -r '.items[] | select(.type == "push_wiki") | .files' "$GH_AW_AGENT_OUTPUT")
+            echo "$FILES" | jq -r 'to_entries[] | @base64' | while read entry; do
+              FILENAME=$(echo "$entry" | base64 -d | jq -r '.key')
+              CONTENT=$(echo "$entry" | base64 -d | jq -r '.value')
+              echo "$CONTENT" > "$FILENAME"
+            done
+        - name: Commit and push
+          run: |
+            git config user.name "github-actions[bot]"
+            git config user.email "github-actions[bot]@users.noreply.github.com"
+            git add -A
+            git diff --cached --quiet && echo "No changes to commit" && exit 0
+            git commit -m "Update wiki pages [agentic-wiki]"
+            git push


This workflow prompt relies on calling a noop safe-output in multiple places (e.g., PR closed without merge / no wiki impact), but safe-outputs: doesn’t declare noop. Also, safe-outputs.jobs.push-wiki doesn’t match any safe-outputs pattern used elsewhere in this repo and may not be supported by gh aw compile, which would break the workflow. Suggest adding a declared noop output and implementing wiki pushing via a supported safe-output handler or a standard post-agent job that consumes agent output.

Suggested change

create-pull-request:

title-prefix: "[agentic-wiki]"

labels: [documentation, automated]

jobs:

push-wiki:

description: >

Push generated wiki pages to the repository wiki.

Pass a JSON object mapping filenames to markdown content.

runs-on: ubuntu-latest

output: "Wiki pages pushed successfully"

permissions:

contents: write

inputs:

files:

description: "JSON object mapping filenames to markdown content, e.g. {\"Home.md\": \"...\", \"_Sidebar.md\": \"...\"}"

required: true

type: string

steps:

- name: Checkout wiki

uses: actions/checkout@v4

with:

repository: ${{ github.repository }}.wiki

token: ${{ secrets.GITHUB_TOKEN }}

- name: Write wiki pages

run: |

FILES=$(jq -r '.items[] | select(.type == "push_wiki") | .files' "$GH_AW_AGENT_OUTPUT")

echo "$FILES" | jq -r 'to_entries[] | @base64' | while read entry; do

FILENAME=$(echo "$entry" | base64 -d | jq -r '.key')

CONTENT=$(echo "$entry" | base64 -d | jq -r '.value')

echo "$CONTENT" > "$FILENAME"

done

- name: Commit and push

run: |

git config user.name "github-actions[bot]"

git config user.email "github-actions[bot]@users.noreply.github.com"

git add -A

git diff --cached --quiet && echo "No changes to commit" && exit 0

git commit -m "Update wiki pages [agentic-wiki]"

git push

noop:

description: >

No-op safe output used when there is no wiki impact or the PR

did not result in any changes that require wiki updates.

output: "No operation performed"

create-pull-request:

title-prefix: "[agentic-wiki]"

labels: [documentation, automated]

push-wiki:

description: >

Push generated wiki pages to the repository wiki using a JSON

object mapping filenames to markdown content.

output: "Wiki pages pushed successfully"

noop is available by default and write wiki is indeed supported.

Copilot · 2026-02-27T00:34:21Z

workflows/agentic-wiki-writer.md

+  pull_request:
+    types: [closed]
+    branches: [main]
+permissions:
+  contents: read
+steps:
+  - name: Pre-stage event payload for sandbox
+    run: |
+      cp "$GITHUB_EVENT_PATH" /tmp/gh-aw/event.json
+      echo "Event payload staged to /tmp/gh-aw/event.json"
+      cat /tmp/gh-aw/event.json
+  - name: Create agentic-wiki directory
+    run: mkdir -p .github/agentic-wiki
+tools:
+  bash:
+    - "find * -type f -not -path '*/node_modules/*' -not -path '*/.git/*'"
+    - "tree *"
+    - "wc *"
+  repo-memory:
+    branch-name: memory/agentic-wiki
+    description: "Source file mappings, content hashes, and file summaries for incremental wiki regeneration"
+    allowed-extensions: [".json", ".md"]
+    max-file-size: 1048576
+    max-file-count: 50
+  github:
+    toolsets: [repos]


The triage steps require reading PR metadata and listing changed files, but the workflow only grants contents: read and configures github.toolsets: [repos]. Other workflows that read PRs use pull-requests: read permissions and broader GitHub toolsets (e.g., default/all) to access pull_request_read APIs. Please add pull-requests: read and adjust the GitHub toolset accordingly so PR inspection works at runtime.

@copilot open a new pull request to apply changes based on this feedback

workflows/agentic-wiki-writer.md

workflows/agentic-wiki-coder.md

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Copilot · 2026-02-28T13:42:52Z

@mrjf I've opened a new pull request, #220, to work on those changes. Once the pull request is ready, I'll request review from you.

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

…lset (#220)

mrjf and others added 3 commits February 26, 2026 10:11

Add agentic-wiki-writer and agentic-wiki-coder workflows

04196dc

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Pre-create agentic-wiki directory outside sandbox

275bc74

mkdir inside the sandbox bash allowlist doesn't work reliably. Move directory creation to a pre-step that runs before the agent. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Encourage mermaid diagrams instead of discouraging them

8e6f3be

The previous prompting was too conservative, causing the agent to almost never generate diagrams even for architecture/flow pages. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

mrjf requested review from Copilot and dsyme February 27, 2026 00:27

Copilot started reviewing on behalf of mrjf February 27, 2026 00:28 View session

Copilot AI reviewed Feb 27, 2026

View reviewed changes

Update workflows/agentic-wiki-writer.md

d6633e2

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Copilot AI mentioned this pull request Feb 28, 2026

Fix agentic-wiki-writer: add pull-requests permission and default toolset #220

Merged

mrjf and others added 3 commits February 28, 2026 13:42

Update workflows/agentic-wiki-writer.md

a27233f

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Update workflows/agentic-wiki-coder.md

94d41d9

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Fix agentic-wiki-writer: add pull-requests permission and default too…

f7d408d

…lset (#220)

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Add agentic-wiki-writer and agentic-wiki-coder workflows#210

Add agentic-wiki-writer and agentic-wiki-coder workflows#210
mrjf wants to merge 7 commits intomainfrom
wiki-workflows

mrjf commented Feb 27, 2026

Uh oh!

Copilot AI left a comment

Uh oh!

Copilot AI Feb 27, 2026

Uh oh!

mrjf Feb 28, 2026

Uh oh!

Copilot AI Feb 27, 2026

Uh oh!

Copilot AI Feb 27, 2026

Uh oh!

mrjf Feb 28, 2026

Uh oh!

Uh oh!

Copilot AI Feb 27, 2026

Uh oh!

mrjf Feb 28, 2026

Uh oh!

Copilot AI Feb 27, 2026

Uh oh!

mrjf Feb 28, 2026

Uh oh!

Uh oh!

Uh oh!

Copilot AI commented Feb 28, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Conversation

mrjf commented Feb 27, 2026

Summary

Test plan

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Copilot AI Feb 27, 2026

Choose a reason for hiding this comment

Uh oh!

mrjf Feb 28, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Feb 27, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Feb 27, 2026

Choose a reason for hiding this comment

Uh oh!

mrjf Feb 28, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Copilot AI Feb 27, 2026

Choose a reason for hiding this comment

Uh oh!

mrjf Feb 28, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Feb 27, 2026

Choose a reason for hiding this comment

Uh oh!

mrjf Feb 28, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Copilot AI commented Feb 28, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants