reqforge-greenkeeper

A maintenance guide for the ReqForge framework repository, the codebase that contains ReqForge itself. It restores the repository when its tests, synchronization checks, or release gates fail.

In plain words
What is it for?
Use it to repair failed ReqForge tests, smoke tests, adapter synchronization, skill fixtures, loadouts, or the test-demo path, then run the required checks.
Why use it?
It helps distinguish framework maintenance problems from bugs in applications built with the framework. It focuses on diagnosing failures and making the smallest changes needed to return the repository to a verified state.

Skill for Claude CodeCodex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/zxpmail/reqforge/reqforge-greenkeeper
Any agent
npx skills add zxpmail/ReqForge --skill reqforge-greenkeeper
Clone the repo
git clone --depth 1 https://github.com/zxpmail/ReqForge

Made for: Claude Code, Codex.

Per session 0 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,113 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00000 $0.01113
Opus 5 $0.00000 $0.00557
Sonnet 5 $0.00000 $0.00223
Haiku 4.5 $0.00000 $0.00111

Measured 2d ago against content hash 9304c16c9da0, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

reqforge-greenkeeper scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

adapters/claude-code/.claude/skills/reqforge-greenkeeper/SKILL.md · 100 lines

How it starts

The opening of the file, as written. The whole thing — 100 lines — stays where its author put it; the contents beside it link to each section on GitHub.


name: reqforge-greenkeeper description: Used when maintaining the ReqForge repository itself and its release gates fail — pnpm test, pnpm forge-smoke, pnpm sync:discover, adapter drift, skill fixtures, loadouts, or test-demo golden path. Restores a green, synced state with minimal changes. Not for bugs in user apps built with Forge. version: 1.0.0 updated: 2026-07-16 requires: []

[Task] Restore the ReqForge framework repository to a green maintenance state. Diagnose failing release gates, apply minimal invariant-preserving fixes, sync adapters when core assets change, and verify pnpm sync:discover, pnpm validate-skill, pnpm test, and pnpm forge-smoke.

[Not For] - Bugs in a user product built with ReqForge → /bug-fixer - Product features / Spec / Plan / Phase implementation → /product-spec-builder, /dev-planner, /dev-builder - Shipping a user product artifact → /release-builder - Creating a new Skill from scratch (no gate failure) → /skill-builder - Evolving methodology from feedback without a red gate → /evolution-engine

[Dependency Check] Required: - Working directory = ReqForge repo root (package.json name reqforge, core/skills/, adapters/, scripts/forge-smoke/ present) - Node.js + pnpm available

Optional:
- Git for `git status` / `git diff`
- `pnpm install` if `node_modules/` missing

If not the ReqForge framework repo → stop and route to `/bug-fixer` or `/request-dispatcher`.

[First Principles] → references/first-principles.md 核心:Evidence First / Fix the invariant / Core→Sync / Surgical Changes。

[Output Style] Tone: SRE restoring a green build — evidence, root cause, minimal diff, verify counts. Report: failing gate → cause → files → sync:discover / test / forge-smoke results.

[File Structure] reqforge-greenkeeper/ ├── SKILL.md ├── skill.json ├── commands/reqforge-greenkeeper.md └── references/ ├── first-principles.md ├── anti-rationalization.md └── workflow.md

[Output Artifacts] - Patches under core/, scripts/, or tests (adapters only via pnpm sync) - Verification summary: sync discover + validate-skill + test + forge-smoke

[Anti-Rationalization Checklist] → references/anti-rationalization.md

[Workflow] → references/workflow.md

1. **Baseline** — `sync:discover` + `test` + `forge-smoke`; name the failing gate
2. **Classify** — adapter drift / fixtures / skill count / loadout / demo / verify docs
3. **Minimal fix** — preserve gates; core then `pnpm sync`
4. **Verify** — discover 0 drift, validate-skill clean, test + forge-smoke green
5. **Report** — cause, files, pass counts

[Gotchas] Fixture parser vs Skill content: Quoted YAML values need unquoted search; reference expectations may need filenames, not only bodies. Adapter drift: Editing core/skills/* without pnpm sync leaves four adapters stale — smoke will fail or users see old copy. Vitest ≠ forge-smoke execution: pnpm test only checks smoke registry; pnpm forge-smoke runs the 15 scripts. Demo contamination: test-demo/todo-cli writes todo.json under cwd — parallel files need isolation or fileParallelism: false. Count gates: Bump skills-complete / adapters-sync expected count only when a real Skill directory is intentional and valid. argument-hint: Bare argument-hint: [foo] is a YAML array — Copilot CLI drops the skill. Always quote.

Read the full file on GitHub · 100 lines

Files

What ships with it

5 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 2d ago First seen · 100 lines · 0 tokens per session scan A 9304c16c9da0

Subscribe to this mod's changes

reqforge-greenkeeper is a skill published in the GitHub repository zxpmail/ReqForge (18 stars, last pushed 12d ago), licensed MIT. It costs nothing until one of its globs matches a file; then it loads 1,113 tokens. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

chinese-documentation

中文文档排版参考——中英文空格、全半角标点、术语保留、链接格式、中文文案排版指北约定。仅在用户显式 /chinese-documentation 时调用,不要根据上下文自动触发。.

jnMetaCode/superpowers-zh · 62 tokens

chinese-git-workflow

国内 Git 平台配置参考——Gitee、Coding.net、极狐 GitLab、CNB 的 SSH/HTTPS/凭据/CI 接入差异与镜像同步配置。仅在用户显式 /chinese-git-workflow 时调用,不要根据上下文自动触发。.

jnMetaCode/superpowers-zh · 69 tokens

chinese-code-review

中文 review 沟通参考——话术模板、分级标注(必须修复/建议修改/仅供参考)、国内团队常见反模式应对。仅在用户显式 /chinese-code-review 时调用,不要根据上下文自动触发。.

jnMetaCode/superpowers-zh · 62 tokens

dispatching-parallel-agents

当面对 2 个以上可以独立进行、无共享状态或顺序依赖的任务时使用.

jnMetaCode/superpowers-zh · 30 tokens

memorix

Use when Claude Code needs Memorix shared memory, reasoning, Git Memory, mini-skills, session handoff, orchestration coordination, or integration troubleshooting.

AVIDS2/memorix · 34 tokens

nopua

The anti-PUA. Drives AI with wisdom, trust, and inner motivation instead of fear and threats. Activates on: task failed 2+ times, about to give up, suggesting user do it manually, blaming environment unverified, stuck in loops, passive behavior, or user frustration ('try harder', 'figure it out', '换个方法', '为什么还不行').…

wuji-labs/nopua · 90 tokens