Scaffold a new Forge subagent (planner/architect/executor/reviewer/debugger/memory-style). Use when adding anything to src/agents/.
한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.
hoangsonww/Forge-Agentic-Coding-CLI262026년 9월 28일 업데이트
무료GitHub에 공개
debug-loop
Systematic debugging playbook for the Forge agentic loop (src/core/loop.ts and src/agents/executor.ts). Use when a task is stuck, looping, or emitting wrong tool calls.
한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.
설치 방법 보기포함된 파일(1)
- SKILL.md1.5 KB
SKILL.md(원문)
설치하기 전에 에이전트에게 전달되는 지시 내용을 확인할 수 있습니다.
The loop is the most expensive place to be wrong. Instrument before you change anything.
1. Reproduce deterministically
FORGE_LOG_LEVEL=debug ./bin/forge.js <command>
Capture the session id. Events land in
~/.config/forge/events/<session>.ndjson.
If the bug only reproduces against a real provider, pin the model and disable router fallback:
FORGE_MODEL=... FORGE_ROUTER_FALLBACK=0 ./bin/forge.js <command>
2. Read the event stream, not the terminal
Each turn emits: turn.start, model.call, tool.call,
tool.result, validation.result, turn.end. Missing or
out-of-order events are your bug.
3. Check the usual suspects, in order
- Mode caps (
src/core/mode-policy.ts) — is the agent hitting turn/token cap? - Validation gate (
src/core/validation.ts) — is a valid step being rejected? - Tool registry — is the requested tool actually registered?
tool.callwithclass: not_foundmeans no. - Permissions — silently denied?
tool.result.denied=true. - State machine (
src/persistence/tasks.ts) — illegal transition attempted?
4. Add a failing test before the fix
Template: test/unit/executor-loop.test.ts. Mock callModel. If the
test you add doesn't turn green after your fix, you fixed the wrong
thing.
5. Finish with verify.
리뷰
아직 리뷰가 없습니다. 사용해 본 소감을 남겨 주세요.
댓글
로그인 없이 쓸 수 있습니다. 사용 후기, 질문, 작동하지 않은 환경 등을 편하게 남겨 주세요.
아직 댓글이 없습니다. 첫 댓글을 남겨 보세요.
같은 저장소의 스킬
Scaffold a new Forge subagent (planner/architect/executor/reviewer/debugger/memory-style).
한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.
hoangsonww/Forge-Agentic-Coding-CLI262026년 9월 28일 업데이트
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/.
한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.
hoangsonww/Forge-Agentic-Coding-CLI262026년 9월 28일 업데이트
Scaffold a new model provider for Forge — class, registry wiring, providerEnum entry, local-catalog classification, router check, and a unit test with mocked transport.
한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.
hoangsonww/Forge-Agentic-Coding-CLI262026년 9월 28일 업데이트
add-tool
무료Scaffold a new Forge tool end-to-end — type, implementation, registration, permission/risk classification, and unit test. Use when adding anything to src/tools/.
한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.
hoangsonww/Forge-Agentic-Coding-CLI262026년 9월 28일 업데이트
add-tool
무료Scaffold a new Forge tool — implementation, registration, permission/risk metadata, sandbox routing, and a unit test. Use when adding anything to src/tools/.
한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.
hoangsonww/Forge-Agentic-Coding-CLI262026년 9월 28일 업데이트