Scaffold a new Forge tool — implementation, registration, permission/risk metadata, sandbox routing, and a unit test. Use when adding anything to src/tools/.
The English summary is being prepared. Showing the original description.
See how to installReview the instructions the agent will receive before you install.
Four places change. Do all four or the tool is half-registered.
src/tools/<name>.ts — the tool module.
zod schemas for input and output.sideEffect (none|read|write|network|exec) and risk
(low|medium|high|critical). Be honest — these drive permission
prompts and auto-approval.src/sandbox/fs.ts helpers.src/sandbox/shell.ts +
classifyCommandRisk.requestPermission
(src/permissions/manager.ts) before the side effect.{ ok, data } / { ok: false, error }. Throw only for
programmer errors, using ForgeRuntimeError.Registration — wire into the registry following the pattern in
an existing tool like src/tools/read-file.ts.
test/unit/<name>.test.ts — at minimum:
Use vi.mock for the permission manager and sandbox boundaries.
Docs — if user-visible, update the tools table in
docs/ARCHITECTURE.md and the README "At a glance" count.
Finish with the verify skill.
No reviews yet. Tell others what you thought.
No login needed. Share how it worked for you, ask a question, or note where it did not run.
No comments yet. Be the first to write one.
Scaffold a new Forge subagent (planner/architect/executor/reviewer/debugger/memory-style). Use when adding anything to src/agents/.
The English summary is being prepared. Showing the original description.
Scaffold a new Forge subagent (planner/architect/executor/reviewer/debugger/memory-style).
The English summary is being prepared. Showing the original description.
Scaffold a new model provider for Forge — class implementation, registry wiring, providerEnum entry, local-catalog classification, and unit test with mocked transport. Use for anything under src/models/.
The English summary is being prepared. Showing the original description.
Scaffold a new model provider for Forge — class, registry wiring, providerEnum entry, local-catalog classification, router check, and a unit test with mocked transport.
The English summary is being prepared. Showing the original description.
Scaffold a new Forge tool end-to-end — type, implementation, registration, permission/risk classification, and unit test. Use when adding anything to src/tools/.
The English summary is being prepared. Showing the original description.
Scaffold a new Forge tool end-to-end — implementation, registration, permission/risk metadata, sandbox routing, and a unit test.
The English summary is being prepared. Showing the original description.