WongStack

agent
Guvenlik Denetimi
Basarisiz
Health Uyari
  • License — License: MIT
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Low visibility — Only 6 GitHub stars
Code Basarisiz
  • process.env — Environment variable access in .agents/skills/memory/scripts/lib/store.mjs
  • network request — Outbound network request in .agents/skills/memory/scripts/lib/store.mjs
  • process.env — Environment variable access in .agents/skills/memory/scripts/lib/transcripts.mjs
  • process.env — Environment variable access in .agents/skills/memory/scripts/memory.mjs
  • spawnSync — Synchronous process spawning in .agents/skills/memory/scripts/run.mjs
  • process.env — Environment variable access in .agents/skills/memory/scripts/run.mjs
  • process.env — Environment variable access in .agents/skills/memory/scripts/session-start.mjs
Permissions Gecti
  • Permissions — No dangerous permissions requested

Bu listing icin henuz AI raporu yok.

SUMMARY

Repo-native workflow for AI coding agents: your team's process, plans, and decisions live in the repo, so Claude Code and Codex run the same explore → plan → apply → ship loop.

README.md

WongStack

Test
License: MIT
Version

Coding agents forget your decisions between sessions, and your process lives in chat and in people's heads. WongStack keeps the process, the plans, and the decisions in the repo, and gives agents a repeatable loop that writes down what each change teaches.

A review page for a planned change: the change list on the left, and a before-and-after view of the selected change on the right

Each plan gets a review.html page like this. You read each change, see it drawn, and add notes before any code is written.

Start here

Make an empty folder and open it in your coding agent. Have a free Cloudflare account ready. Then paste this:

Read and follow
https://raw.githubusercontent.com/matthewwong525/WongStack/refs/heads/main/.agents/skills/wong-setup/SKILL.md
to install WongStack in this folder and walk me through the first workflow.

The agent asks for one Cloudflare token first, with the exact click path. Then it asks how you work, plans the install, applies it, and saves the result. You end with the workflow, a starter app online, and session memory. In a folder that already has files, setup stops and says so.

Claude Code and Codex get full support. Other agents, such as Cursor, can follow the workflow skills, because they are plain Markdown files. They get no hooks and no session memory.

What you get

  • Process in the repo, not in chats, docs, and people's heads.
  • One command for each stage of the work, from the first idea to the merge.
  • A record written during the work. Plans, decisions, and lessons are written down as part of each step, not afterward.
  • A reviewable package for each change, which your team inspects before it joins main.
  • Memory across sessions. Each session starts with the facts that earlier sessions learned. The store is in your Cloudflare account, not in git.
  • No lock-in to one agent. The durable part is the files in the repo.

The commands

/explore -> /plan -> /apply -> /save -> /continue -> /ship

You do not have to run each one. A command whose input is missing runs the one before it, so /apply plans first when there is no plan. The change loop owns the details.

Command What it does
/explore Think through an idea before you decide what to do.
/plan Write the plan, tasks, and decisions, and build the review.html page.
/apply Do the planned work, then save it when every task is complete.
/save Commit, push, open or update the pull request, and wait for CI. A plain conversation saves only its facts.
/continue Pick up saved work later, from any machine or session.
/ship Finish the change, merge it, and keep the record of what shipped.
/improve [area] Review recent work and one area, then ship one maintenance fix. --audit-only reports findings with no edits.
/routine <when>: <prompt> Run a prompt or command on a schedule. Optional: it needs Paseo.
/wong-sync Get the latest WongStack and plan the update, up to a review page.

Setup puts the app online on the Cloudflare stack: each change gets a preview link, and a merge deploys it.

How it compares

Plain AGENTS.md OpenSpec alone GitHub Spec Kit WongStack
Agent instructions in the repo Yes Yes Yes Yes
Plans and specs in the repo No Yes Yes Yes, through OpenSpec
Git steps No No Branches and commits, with the opt-in git extension Branch, commit, PR, CI wait, and merge
Facts kept between sessions No No No Yes
Preview deploy per change No No No Yes, on Cloudflare
Agents Many 30+ tools Many, by integration Claude Code and Codex in full
Setup needs One file Node.js Python 3.11+ and uv Node.js, gh, and a Cloudflare account

Checked against each project's README in September 2026.

Repository layout

Path What it holds
AGENTS.md The instructions each agent reads first. CLAUDE.md is a link to it.
.agents/ The skills, path rules, hooks, and agent settings. .claude and .codex are links to it.
wiki/ Reusable process and conventions.
openspec/ Active changes, shipped specs, and the archive of what shipped and why.
app/ The starter app: React and Vite on a Cloudflare Worker.
schema/ The app's database migrations and staging seed data.
scripts/ The deploy pipeline, the payload checks, and the tests.
.github/ CI workflows, issue and PR templates, and the contributing guide.
VERSION, CHANGELOG.md The current release, and what changed in each release.
LICENSE, SECURITY.md, CODE_OF_CONDUCT.md MIT terms, how to report a vulnerability, and community rules.
.env.example, .dev.vars.example The names of the local and Worker secrets, with no values.
paseo.json Copies .env into each new Paseo worktree.
.nvmrc The Node.js version.
.gitattributes, .editorconfig, .gitignore LF line endings, editor basics, and the files git ignores.

Requirements

  • A coding agent that edits files, runs shell commands, and asks questions.
  • gh, signed in, and git. Setup creates the GitHub repo.
  • Node.js 22, the version in .nvmrc.
  • OpenSpec: npm install -g @fission-ai/[email protected].
  • curl, for Cloudflare provisioning.
  • A Cloudflare account (the free plan works) and one user token. Cloudflare is required, because session memory and hosting run there. The token stays in the git-ignored .env on your computer. SECURITY.md says what each token can do, and the credentials page has the click path.
  • On Windows, run git config --global core.symlinks true and turn on Developer Mode before you clone. The skills folder links are symbolic links (why).

The setup prompt helps with missing pieces. Required tools says why each is needed.

Work from the source

Fork first, then clone your fork:

gh repo fork matthewwong525/WongStack --clone && cd WongStack

A clone of this repository sends /save pushes to a repository you cannot write to. In your fork, the commands work, because this repo uses WongStack itself. Session memory stays off: .agents/.wong-stack.json names the maintainer's store, and you have no token for it. The contributing guide says how to send a change back.

Learn more

License

WongStack is released under the MIT License.

Yorumlar (0)

Sonuc bulunamadi