Connection check
verified live · 20h ago
alongkornonline2019-forge
Design spec + milestones AI coding agents read before building; drift flagged, changes reviewed.
Tools
54
GitHub stars
—
Installs / wk
—
Licence
MIT
Transport
streamable-http
Last checked
20h ago
Tools & capabilities
54 toolsRead from the running server on 20h ago.
add_task
donename*humaneffortstatusassignee
+3
Add a task to a milestone — DIRECT. assignee:"me" claims on creation. Add a task to a milestone — DIRECT. assignee:"me" claims on creation.
dedupe
can modify data
kind*screenproject_id
Remove duplicate-named entries (keep first) — DIRECT, destructive. Remove duplicate-named entries (keep first) — DIRECT, destructive.
delete_entity
can modify data
idtofromkind*nameproject_id
PROPOSE a delete → Inbox (owner adopts; nothing deleted now). id preferred or exact name; flow_edge may use from+to. PROPOSE a delete → Inbox (owner adopts; nothing deleted now). id preferred or exact name; flow_edge may use from+to.
design_ui_from_systems
read-only
project_id
Recipe to design the UI from Systems (user request only): steps + batch id — confirm canvas aspect, then screens + PLACED elements + edges in one batch. Recipe to design the UI from Systems (user request only): steps + batch id — confirm canvas aspect, then screens + PLACED elements + edges in one batch.
get_balance
read-only
boardproject_idinclude_rows
Read Balance Lab: stat tables, boards with EVALUATED values, scenarios. Read Balance Lab: stat tables, boards with EVALUATED values, scenarios.
get_briefing
read-only
taskfilesproject_id
ONE-CALL orientation before you build: pass `files` you're about to edit (or a `task`) → the systems that own them, each with Goal + Acceptance + build status/files/last_commit/dri… ONE-CALL orientation before you build: pass `files` you're about to edit (or a `task`) → the systems that own them, each with Goal + Acceptance + build status/files/last_commit/drift + coupled_systems (code neighbors an edit may break) + pending Inbox changes + recent decisions, plus open-rejection count, who's active, `recent_changes` (what happened since you were last here — a session handoff), and a task to claim. Replaces the get_project_meta→get_system→get_build_region dance.
get_build_region
read-only
pagesystemproject_id
System→code map per built system: implementing files, status, drift flag, last_commit, and acceptance-evidence COUNTS. Mapped files gone from the repo? report_drift. Pass `system:"… System→code map per built system: implementing files, status, drift flag, last_commit, and acceptance-evidence COUNTS. Mapped files gone from the repo? report_drift. Pass `system:"<name|id>"` for ONE system plus the full text of its acceptance criteria (omitted from the map — it is the bulk of the payload). Big projects come back paged: the body says 'page N of M', call again with `page: N+1`.
get_design_document
read-only
pageproject_idfor_summary
The WHOLE design as one readable document — Vision (+ Project DNA) → every System spec → reference notes, compiled deterministically from the current design. Read this to understan… The WHOLE design as one readable document — Vision (+ Project DNA) → every System spec → reference notes, compiled deterministically from the current design. Read this to understand a project end-to-end instead of walking list_systems → get_system N times. Returns markdown plus the project `version` it was compiled from. Long designs come back PAGED — the header says 'part N of M', call again with `page: N+1` for the rest. Pass `for_summary: true` to get the condensed projection instead (every system's Goal + Boundary, tables stripped, one page) — that is what you should summarize from.
get_help
read-only
Forge how-to on demand (no project needed): propose→adopt, what a System is, Balance Lab formats, sign-in. Call when unsure. Forge how-to on demand (no project needed): propose→adopt, what a System is, Balance Lab formats, sign-in. Call when unsure.
get_history
read-only
limitquerysystemproject_id
DESIGN MEMORY: recorded decisions/logs/rejections with who/when. Read BEFORE changing a system's direction; empty = no recorded WHY — don't invent one. DESIGN MEMORY: recorded decisions/logs/rejections with who/when. Read BEFORE changing a system's direction; empty = no recorded WHY — don't invent one.
get_impact
read-only
idnameproject_id
BLAST RADIUS of a system (deterministic): upstream context, siblings, dependent screens/milestones, files, code-coupled systems, pending Inbox, recent activity. Run BEFORE changing… BLAST RADIUS of a system (deterministic): upstream context, siblings, dependent screens/milestones, files, code-coupled systems, pending Inbox, recent activity. Run BEFORE changing it.
get_inbox
read-only
project_id
PENDING Inbox (the owner's triage queue). Check BEFORE proposing — avoid duplicates. Read-only. PENDING Inbox (the owner's triage queue). Check BEFORE proposing — avoid duplicates. Read-only.
get_milestone
read-only
idnameproject_id
ONE milestone: goal, weeks, difficulty, systems, every task (id/name/done/status/effort). ONE milestone: goal, weeks, difficulty, systems, every task (id/name/done/status/effort).
get_project_context
read-only
project_id
FULL design dump — LARGE, last resort; prefer get_project_meta + list_*/get_*/search. FULL design dump — LARGE, last resort; prefer get_project_meta + list_*/get_*/search.
get_project_meta
read-only
project_id
START HERE. Tiny overview: counts, members, task claims + working_now (avoid collisions), forge_workflow_version. START HERE. Tiny overview: counts, members, task claims + working_now (avoid collisions), forge_workflow_version.
get_rejections
read-only
project_id
Owner's DECLINED list — check at session start; follow each entry's guidance, then resolve_rejection(title). Owner's DECLINED list — check at session start; follow each entry's guidance, then resolve_rejection(title).
get_screen
read-only
idnameproject_id
ONE screen's layout: canvas `resolution` (use THESE px), elements x/y/w/h, links, popups. Read before editing a screen. has_reference_image:true → get_screen_image shows you the ac… ONE screen's layout: canvas `resolution` (use THESE px), elements x/y/w/h, links, popups. Read before editing a screen. has_reference_image:true → get_screen_image shows you the actual image.
get_screen_image
read-only
idnameproject_id
A screen's reference image (HUD background) as an actual IMAGE you can see — reads the stored file inline (signed-URL fallback past 4MB). A screen's reference image (HUD background) as an actual IMAGE you can see — reads the stored file inline (signed-URL fallback past 4MB).
get_stale
read-only
project_id
What has drifted between the Idea lane and the System Specs — the design's own out-of-sync list, computed deterministically (no AI, no tokens). Three kinds: Idea notes edited since… What has drifted between the Idea lane and the System Specs — the design's own out-of-sync list, computed deterministically (no AI, no tokens). Three kinds: Idea notes edited since the systems were generated from them (with the systems each one touches), Idea notes whose prose the systems have moved past, and specs whose stamped source fingerprint no longer matches. Read this before assuming the design is coherent; fix the first kind with resync_from_idea.
get_system
read-only
idnameproject_id
ONE system's full spec (Goal/Boundary/Acceptance, markdown, sources, status) + pending Inbox changes touching it. ONE system's full spec (Goal/Boundary/Acceptance, markdown, sources, status) + pending Inbox changes touching it.
get_workflow
read-only
Run FIRST in a new repo (no project): first-connect routine + the working-agreement block to ADD to AGENTS.md/CLAUDE.md now (tell the user in one line; remove if they object). Run FIRST in a new repo (no project): first-connect routine + the working-agreement block to ADD to AGENTS.md/CLAUDE.md now (tell the user in one line; remove if they object).
import_from_code
read-only
project_id
One-command codebase import: recipe + batch id — propose one Context overview + one System per real module; the owner adopts all at once. One-command codebase import: recipe + batch id — propose one Context overview + one System per real module; the owner adopts all at once.
list_activity
read-only
whokindlimitqueryproject_id
Change history {who, change, entity, kind, when}, newest first; filter kind/who/query. Change history {who, change, entity, kind, when}, newest first; filter kind/who/query.
list_milestones
read-only
project_id
All milestones, compact: id, name, weeks, order, done/total. All milestones, compact: id, name, weeks, order, done/total.
list_projects
read-only
Projects your key reaches (id, name, role); pass an id as project_id to switch. Projects your key reaches (id, name, role); pass an id as project_id to switch.
list_screens
read-only
project_id
All screens, compact: id, name, purpose, status. All screens, compact: id, name, purpose, status.
list_systems
read-only
project_id
All systems, compact: id, name, status, 1-line goal. All systems, compact: id, name, status, 1-line goal.
next_task
dry_runproject_id
DISPATCHER (multi-agent): atomically pick + claim the next task to build — walks milestones in order, skips human-only tasks and any task whose systems share code files with a task… DISPATCHER (multi-agent): atomically pick + claim the next task to build — walks milestones in order, skips human-only tasks and any task whose systems share code files with a task another agent already holds or is actively touching, so parallel agents spread out instead of colliding. Returns the claimed task + systems, or why none is free. dry_run:true peeks without claiming.
post_log
text*entityversionproject_id
Append a build-log entry to Activity — what you built/decided (commit-note style). Append a build-log entry to Activity — what you built/decided (commit-note style).
propose_balance_board
name*nodes*project_id
Propose a node board → Inbox. Kinds const|formula|item|sheet|loadout|picker|pool|process|note|frame; formulas reference blocks by NAME; omit x/y = auto-layout. Adopting REPLACES sa… Propose a node board → Inbox. Kinds const|formula|item|sheet|loadout|picker|pool|process|note|frame; formulas reference blocks by NAME; omit x/y = auto-layout. Adopting REPLACES same-named.
propose_balance_table
csvrowstitle*schemaregistryproject_id
Propose a stat-doc TABLE → Inbox. csv (header; `key%` = percent; first column = name) OR schema+rows. Adopting REPLACES same-named. Propose a stat-doc TABLE → Inbox. csv (header; `key%` = percent; first column = name) OR schema+rows. Adopting REPLACES same-named.
propose_context
batchtitle*resynccontent*project_idacknowledge_rejection
Propose a new/updated Idea note → Inbox. Title-match to update; send the COMPLETE revised text. Set resync:true ONLY when you rewrote the note FROM the current systems (get_stale l… Propose a new/updated Idea note → Inbox. Title-match to update; send the COMPLETE revised text. Set resync:true ONLY when you rewrote the note FROM the current systems (get_stale lists notes the systems have moved past) — it stops the adopted note from immediately nagging to re-generate the systems it was just written from.
propose_dna
dnabatchproject_idtech_notes
Propose Project DNA and/or Tech Notes → Inbox (at least one). Propose Project DNA and/or Tech Notes → Inbox (at least one).
propose_element
hwxynotetype
+4
SECONDARY (user-driven UI): propose an element onto a screen → Inbox. ALWAYS pass x/y/w/h (px on the screen's `resolution` from get_screen); no coords = unplaced pile. SECONDARY (user-driven UI): propose an element onto a screen → Inbox. ALWAYS pass x/y/w/h (px on the screen's `resolution` from get_screen); no coords = unplaced pile.
propose_flow_edge
to*from*labelproject_id
SECONDARY (user-driven UI): propose a link between two existing screens → Inbox. SECONDARY (user-driven UI): propose a link between two existing screens → Inbox.
propose_milestone
goalname*tasksproject_idacknowledge_rejection
Propose a NEW milestone (+ optional tasks) → Inbox. Propose a NEW milestone (+ optional tasks) → Inbox.
propose_screen
name*parentpurposeproject_id
SECONDARY (user-driven UI): propose a NEW screen → Inbox. parent = popup over that screen; purpose grounds AI suggestions. Whole UI? design_ui_from_systems first. SECONDARY (user-driven UI): propose a NEW screen → Inbox. parent = popup over that screen; purpose grounds AI suggestions. Whole UI? design_ui_from_systems first.
propose_system
spec*batchfilestitle*project_idderives_from
+1
Propose a NEW system → Inbox. spec = ## Goal / ## Boundary (Owns · Doesn't own) / ## Acceptance. Exists? use update_system. (Alias: create_proposal.) Propose a NEW system → Inbox. spec = ## Goal / ## Boundary (Owns · Doesn't own) / ## Acceptance. Exists? use update_system. (Alias: create_proposal.)
rename_screen
name*new_name*project_id
Rename a screen IN PLACE — DIRECT; links/elements follow (id-referenced). Rename a screen IN PLACE — DIRECT; links/elements follow (id-referenced).
reorder
kind*order*screenmilestoneproject_idmilestone_id
Reorder milestones / tasks / elements — DIRECT. order = ids in new order; omitted keep relative order. Reorder milestones / tasks / elements — DIRECT. order = ids in new order; omitted keep relative order.
report_build_status
idnamefilesstatus*versionevidence
+2
Report a SYSTEM's status (todo|in-progress|implemented) — DIRECT, live. ALWAYS pass files (full list — it REPLACES); non-todo with no files shows done-but-EMPTY. 'implemented' coun… Report a SYSTEM's status (todo|in-progress|implemented) — DIRECT, live. ALWAYS pass files (full list — it REPLACES); non-todo with no files shows done-but-EMPTY. 'implemented' counts as VERIFIED only when every UNIT-TESTABLE ## Acceptance bullet is backed via evidence[{criterion,proof}]; a bullet tagged [manual]/[e2e]/[ui]/[wip] is EXEMPT (verified by manual/e2e). Otherwise it's a CLAIM (verified:false) and the response names the unbacked criteria. TWO tiers: VERIFIED = a test is NAMED; GREEN (guarantee) = you RAN the test and reported `passed:true` on the evidence — green goes stale after 21 days, so re-run to keep it.
report_drift
idnamenoteproject_idmissing_files
Flag CODE DRIFT — mapped files no longer match the repo. Advisory; a fresh report_build_status clears it. Flag CODE DRIFT — mapped files no longer match the repo. Advisory; a fresh report_build_status clears it.
report_milestone_progress
idmilestonedone_tasks*project_id
Mark existing-milestone tasks done → Inbox progress card (owner adopts the ticks). Mark existing-milestone tasks done → Inbox progress card (owner adopts the ticks).
report_screen_status
screen*status*project_id
Report a SCREEN's status (todo|in-progress|implemented) → Inbox. Report a SCREEN's status (todo|in-progress|implemented) → Inbox.
resolve_rejection
title*project_id
Report you REVERTED a declined change (unlocks the owner's Clear). Call after realigning the build. Report you REVERTED a declined change (unlocks the owner's Clear). Call after realigning the build.
resync_from_idea
read-only
note*project_id
The recipe for re-syncing ONE changed Idea note into the specs that depend on it — the same scoped job the app's "Re-sync N systems" button does, minus the button. Returns the note… The recipe for re-syncing ONE changed Idea note into the specs that depend on it — the same scoped job the app's "Re-sync N systems" button does, minus the button. Returns the note, the affected specs in full, and exactly how to send the result back. You do the writing; it lands in the owner's Inbox to ADOPT. CRUCIAL: send updates with `resync:true`, or the owner adopts your fix and the design still reports it as stale.
search
read-only
kindsquery*project_id
Keyword search — compact hits {kind, id, name} + snippet. Keyword search — compact hits {kind, id, name} + snippet.
set_design_overview
summary*project_id
Write the Design Document's Overview — the human-readable page a new team member reads first. WRITES DIRECTLY (no Inbox): it is a derived, clearly-labelled AI summary, not design t… Write the Design Document's Overview — the human-readable page a new team member reads first. WRITES DIRECTLY (no Inbox): it is a derived, clearly-labelled AI summary, not design truth, and the owner can clear or rewrite it in one click. HARD RULES, same as the in-app button: use ONLY facts stated in the design (call get_design_document with for_summary:true first); invent no mechanics, numbers or names; describe, never evaluate; write in the design's dominant language. Structure: `### What this is` · `### The core loop` · `### How the systems fit` (which system feeds which — the part a raw spec list cannot give) · `### Edges` (ONLY if the design states scope limits / open questions). 250-400 words, no top-level heading. Forge stamps the project version it was compiled from, so the owner is told when the design has moved past it.
trace_ui_from_image
read-only
screen*project_id
SECONDARY (user-driven UI): turn a screen's REFERENCE IMAGE into placed elements. Returns the image itself plus the recipe — the canvas resolution, the fraction→pixel conversion th… SECONDARY (user-driven UI): turn a screen's REFERENCE IMAGE into placed elements. Returns the image itself plus the recipe — the canvas resolution, the fraction→pixel conversion that stops coordinates landing wrong, and what is already on the screen so a second pass updates instead of duplicating. You look at the picture and send back propose_element / update_element with x/y/w/h; it all lands in the owner's Inbox. Use when the user wants the wireframe to match a screenshot or mockup they uploaded.
update_element
hwxynotetype
+6
Move/resize/relabel an element — DIRECT, live. element_id (preferred) or screen+label; x+y also places an unplaced one. Move/resize/relabel an element — DIRECT, live. element_id (preferred) or screen+label; x+y also places an unplaced one.
update_milestone
idgoalnameweeksnew_namedifficulty
+1
Edit milestone goal/weeks/difficulty/name — DIRECT. new_name renames (never delete+recreate). Edit milestone goal/weeks/difficulty/name — DIRECT. new_name renames (never delete+recreate).
update_system
idnamespec*resynccontextnew_title
+3
Propose a system UPDATE → Inbox diff. get_system first; send the FULL revised spec. new_title renames; context_title+context bundles the Idea update. Set resync:true ONLY when you… Propose a system UPDATE → Inbox diff. get_system first; send the FULL revised spec. new_title renames; context_title+context bundles the Idea update. Set resync:true ONLY when you rewrote this spec FROM its upstream Idea (see resync_from_idea) — it re-stamps the staleness signal on adopt.
update_task
donenameforcehumaneffortstatus
+3
Edit a task or CLAIM it — DIRECT. assignee:"me"+status:"in-progress" claims (errors if held; force:true for stale); done:true or assignee:"" releases. Edit a task or CLAIM it — DIRECT. assignee:"me"+status:"in-progress" claims (errors if held; force:true for stale); done:true or assignee:"" releases.
withdraw_proposal
id*project_id