Skip to main content Home Creators chachamaru127 claude-code-harness harness-plan
harness-plan HAR: Research-backed, team-validated task planning, Plans.md management, progress sync. Trigger: create a plan, add tasks, update Plans.md, mark complete, check progress. Do NOT load for: implementation, review, release.
Jump to install Skills Marketplace Discover and explore AI skills built by the community.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Show prompt details A direct command skips the review prompt. Inspect the source before running it.
npx skills add https://github.com/Chachamaru127/claude-code-harness --skill harness-planThe command stays on one line. Scroll horizontally to inspect it before copying.
Prefer a local copy? Download the files currently available to SkillsMP.
Download Zip Downloading... More from this repository Generic release automation for projects using Keep a Changelog + GitHub. Single confirmation gate then end-to-end automation: bump detection, CHANGELOG promotion, PR/main merge, tag, GitHub Release. Trigger: release, version bump, publish. Do NOT load for: implementation, review, planning, setup.
Generic release automation for projects using Keep a Changelog + GitHub. Single confirmation gate then end-to-end automation: bump detection, CHANGELOG promotion, PR/main merge, tag, GitHub Release. Trigger: release, version bump, publish. Do NOT load for: implementation, review, planning, setup.
Generate an Acceptance Demo HTML for non-engineer vibecoders right before ship/wait/reject decision. Reads back the acceptance_criteria that were stored as personal-preference.v1 by harness-plan-brief (joined by user_request_hash), then renders a single-file HTML showing each criterion as verified or unverified along with a ship/wait/reject recommendation. Use when the user asks for an acceptance review, wants to decide whether to ship a delivered task, or says: acceptance demo, accept demo, åãå
¥ãå€æ, åå
¥ã¬ãã¥ãŒ, ship/wait/reject å€å®, æ€åã¬ãã¥ãŒ. Do NOT load for: implementation, code review, release work.
name harness-plan description HAR: Research-backed, team-validated task planning, Plans.md management, progress sync. Trigger: create a plan, add tasks, update Plans.md, mark complete, check progress. Do NOT load for: implementation, review, release. description-en HAR: Research-backed, team-validated task planning, Plans.md management, progress sync. Trigger: create a plan, add tasks, update Plans.md, mark complete, check progress. Do NOT load for: implementation, review, release. description-ja HAR:調æ»ã»æ¡ç¹ã»èšæ¶ç¢ºèªã»TeamAgent/ãµããšãŒãžã§ã³ãæ€èšŒã€ãã®ã¿ã¹ã¯èšç»ãPlans.md管çãé²æåæãæ
åœãèšç»äœã£ãŠãã¿ã¹ã¯è¿œå ãPlans.mdæŽæ°ãå®äºããŒã¯ãé²æ確èªã§èµ·åãå®è£
ã»ã¬ãã¥ãŒã»ãªãªãŒã¹ã«ã¯äœ¿ããªãã kind workflow purpose Maintain co-required planning output for the spec.md product contract and Plans.md task contract trigger create a plan, add tasks, update Plans.md, check progress shape workflow role generator pair harness-sync owner harness-core since 2026-05-05 allowed-tools ["Read","Write","Edit","Bash","Grep","Glob","WebSearch","Task"] argument-hint [create|add|update|sync|sync --no-retro|--ci] user-invocable true effort medium
Harness Plan
Harness ã®çµ±åãã©ã³ãã³ã°ã¹ãã«ã
以äžã®3ã€ã®æ§ã¹ãã«ãçµ±å:
planning (plan-with-agent) â ã¢ã€ã㢠â Plans.md ãžã®èœãšã蟌ã¿plans-management â ã¿ã¹ã¯ç¶æ
管çã»ããŒã«ãŒæŽæ°sync-status â Plans.md ãšå®è£
ã®åæ確èª
Quick Reference
ãŠãŒã¶ãŒå
¥å ãµãã³ãã³ã åäœ "èšç»ãäœã£ãŠ" / /harness-plan create createSpec delta / skip reason â Plans.md task çæ "ã¿ã¹ã¯ãè¿œå ããŠ" / /harness-plan add addPlans.md ã«æ°ã¿ã¹ã¯è¿œå "å®äºã«ããŠ" / /harness-plan update updateã¿ã¹ã¯ããŒã«ãŒã cc:å®äº ã«å€æŽ "ä»ã©ãïŒ" / /harness-plan sync syncå®è£
ãšPlans.mdãç
§åã»åæ /harness-syncsyncé²æ確èªïŒç¬ç« sync surface ãšåçïŒ /harness-plan createcreatespec.md / Plans.md äºæ£æ¬ã®èšç»äœæ /harness-plan listlistplans/manifest.json ã® named Plans ãäžèŠ§/harness-plan switch <name>switchactive plan ã .claude/state/active-plan.json ã«ä¿å
ã¹ã³ãŒãæ¢å®: ä»é²ããããå
šäœæ¥ïŒoperator è£å® 2026-07-24ïŒ
èšç»äŸé ŒïŒcreate / åŒæ°ãªãèµ·å / ãèšç»ããŠãïŒã®æ¢å®è§£é㯠ãçŸæç¹ã§çæå¯èœãªãã¹ãŠã®äœæ¥ã ã
ãŠãŒã¶ãŒãç¯å²ãæ瀺ããªãéããäŸé Œæèã«å
¥ã open itemïŒæ® phaseãæªåŠç follow-upãæ¢ç¥ã®æ¹åç¹ãäŸé Œæã§èšåãããåé¡ãã¹ãŠïŒãæŽãåºããŠèšç»ã«å«ãããåæã«æå°ãµãã»ãããžçµããªã
件æ°ãå€ãå Žåãçµã蟌ã¿ã§ã¯ãªããå
šéã Required / Recommended / Optional / Reject ã«åé¡ããŠæ瀺ãããé€å€ã¯ Reject ãšããŠçç±ãæ瀺ããïŒé»ã£ãŠèœãšããªãïŒ
ãäžéšã ãå
ã«ãã劥åœãšå€æããå Žåã¯ãçµã£ãèšç»ã§ã¯ãªããå
šéèšç»ã®äžã®å®è¡é åºïŒPhase åå² / DependsïŒãšããŠè¡šçŸãã
Literal companion commandsïŒCC 2.1.108+ïŒ
/recap: ä¹
ãã¶ãã«æ»ã£ãæã«èŠçŽãåãçŽããŠãã sync ãžå
¥ã/undo: /rewind ã®å¥åãçŽåã® plan æŽæ°ãå³åº§ã«æ»ãããæã«ãã®ãŸãŸäœ¿ã
ãµãã³ãã³ã詳现
æšæºã®èšç»å質å¥çŽ harness-plan ã¯ãspec.md product contract and Plans.md task contract ã® co-required planning output ãäœã planning surface ã§ããã
precedence 㯠spec.md > sub-spec > Plans.md ã®ãŸãŸç¶æããã
Plans.md 㯠task ledgerãroot spec.md 㯠product contract ã§ãããäžäžé¢ä¿ã¯åŽ©ããªãã
æž¡ãããæ
å ±ããã®ãŸãŸ Plans.md ã«èœãšããªãã
èšç»äœæã倧ã㪠task è¿œå ã§ã¯ãææ°æ
å ±ã»æ¢åä»æ§ã»èšæ¶ã»TeamAgent / ãµããšãŒãžã§ã³ãã«ããè€æ°èŠç¹ã®è°è«ã確èªãã
ãã®ãããã¯ãã«åãå
¥ããã¹ãèŠçŽ ã ãã task contract ã«å€æããã
/harness-plan create 㯠Spec delta ãŸã㯠Spec skip reason ãš Plans.md task çæãã»ããã§è¿ãã
åºåã«ã¯å¿
ã Spec delta ãŸã㯠Spec skip reason ãå«ããã
Spec delta / Spec skip reason 㯠Harness ãçæããconsumer ã¯æ¿èªã»ä¿®æ£ã ãè¡ãã
Non-trivial planning gate :
åçºã»è»œåŸ®ã¿ã¹ã¯ã§ãªã planning ã¯ãTeamAgent ãŸãã¯ãµããšãŒãžã§ã³ãåæã§æ±ãã
ããã§ã® non-trivial ã¯ãè€æ° task / è€æ° file / è€æ° session / product behavior / API / data model / æš©é / 課é / å€éšé£æº / é
åžé¢ / ã»ãã¥ãªãã£ã«åœ±é¿ããäŸé Œãæãã
Task tool ã䜿ããå Žå㯠Product / Architecture / Security / QA / Skeptic ã®ç¬ç«èŠç¹ãèµ°ãããã
䜿ããªãå Žå㯠ãµããšãŒãžã§ã³ãæªäœ¿çš ãšæ瀺ããåã芳ç¹ãåç¬ã§åããŠè©äŸ¡ããã
non-trivial planning ã®åºåã«ã¯ã次ã®æ€èšŒãå¿
ãå«ããã
team_validation_mode: not_required_lightweight / native / subagent / manual-pass / unavailablespec.md / sub-spec / Plans.md ã®æŽåæ§harness-mem / harness-recall / repo memory ã«ããè»èŒªã®åçºæé²æ¢ç¢ºèª
ãããã¯ãç®çããå€ããŠããªãã
ã»ãã¥ãªãã£ãæš©éãç§å¯æ
å ±ããµãã©ã€ãã§ãŒã³ã«åé¡ããªãã
lint / formatter baseline ãããããsource code changes ãå«ã plan ã§æªèšå®ãªããå®è£
task ã®åã« setup task ã眮ã
ã¡ãããšåãèšç»ããã€ãŸã test / smoke / CI / review / release gate ã task DoD ã«èœã¡ãŠããã
軜é task 㯠team_validation_mode: not_required_lightweight ã§ããã
non-trivial planning 㯠native / subagent / manual-pass ã®ããããã䜿ãã
unavailable ã®ãŸãŸ Required ã«ããŠã¯ãããªãã
Product / Architecture / Security / QA / Skeptic ã¯æ€èšŒ perspective ã§ãããagent_type åã§ã¯ãªãã
å©çšå¯èœãª TeamAgent / Task ãµããšãŒãžã§ã³ãã« perspective ãšããŠäŸé Œããä»»æ agent spawn ãèŠæ±ããªãã
Security gate ã¯ç§å¯æ
å ±ã®å®èªåãèŠæ±ããªãã
.env ã secret ã® read ãå¿
èŠã«ãªãå Žå㯠Risk Gate ãšããŠæ¢ããèš±å¯ãããæ¢å guard / evidence ã§ç¢ºèªããã
create ã§æ°ããèšç»ãäœãadd 㧠product behavior / API / æš©é / 課é / å€éšé£æº / é
åžé¢ã«åœ±é¿ãã task ã足ããŠãŒã¶ãŒãå€éšãããã¯ãã競åãä»æ§æ¡ãæ¹åæ¡ãæ¯èŒææãæž¡ãã
æ¢åä»æ§ãéå»å€æãšã®è¡çªãªã¹ã¯ããã
軜ãæ±ã£ãŠããå Žé¢ :
marker æŽæ°ã ãã® update
status ç
§åã ãã® sync
typoãformatãREADME/CHANGELOG ã®ã¿
æ¢å spec ãšãã¹ãã§æ£è§£ãåºå®ãããŠããçãå€æŽ
å
¥åæ
å ±ãå解ããè©äŸ¡å¯Ÿè±¡ã»æ¡ç¹è»žã»äžç¢ºããªäºå®ãæ瀺ãã
ææ°æ
å ±ãååŸãããå€éšäºå®ã¯ WebSearch / å
¬åŒããã¥ã¡ã³ã / äžæ¬¡æ
å ±ãåªå
ããéèŠç¹ã¯è€æ°ãœãŒã¹ã§ã¯ãã¹ãã§ãã¯ãã
æ¢åä»æ§ã»root spec.mdã»Plans.mdã»READMEã»docsã»CLAUDE.mdã»é¢é£ skill ã確èªãã
harness-mem / harness-recall / .claude/agent-memory/ / .claude/state/ ãªã©ãå©çšå¯èœãªèšæ¶é¢ã project-scoped ã§ç¢ºèªãã
non-trivial planning ã§ã¯ TeamAgent / Task ãµããšãŒãžã§ã³ãã䜿ããProduct / Architecture / Security / QA / Skeptic ãªã©ç°ãªãèŠç¹ã§ç¬ç«ã¬ãã¥ãŒãã
source code changes ãå«ã plan ã§ã¯ lint / formatter baseline ã確èªããæªèšå®ãªã setup task ãå
è¡ããã
äžç«çãªæ¡ç¹ã¬ãã¥ãŒãåºããRequired / Recommended / Optional / Reject ã«åé¡ãã
$easy 圢åŒã§ãææ¡å
容ã»çç±ã»ã©ããªãã®ããå ±åããæ¡çšããæ¡ã ãã root spec.md / Plans.md / test task ãžèœãšã蟌ã
Lane Taxonomy + Stage Gate Fast / Gate / Release ã¯ æ° skill ã§ã¯ãªã Plans metadata ãšããŠæ±ããPlans.md ã® 5 column ãã³ãã¬ãŒãïŒTask / å
容 / DoD / Depends / StatusïŒã¯å€æŽããã
laneïŒ[lane:fast] / [lane:gate] / [lane:release]ïŒã»stageïŒæ€èšŒâèšç»âTDDå®è£
âã¬ãã¥ãŒâPR closeout ã® 5 段éïŒã»unknown data contractïŒnot_observed != absentã確èªã§ããªãäºå®ã¯ unknown ãšæ瀺ïŒã
å
容ïŒContentïŒãŸã㯠DoD ã®å
é ã«åã蟌ããã¿ã°äžèŠ§ã»worked exampleã»stage å¥ DoD äŸã¯
references/create.md ãåç
§ã
create â èšç»äœæ ã¢ã€ãã¢ã»èŠä»¶ããã¢ãªã³ã°ããå®è¡å¯èœãª Plans.md ãçæããã
äŒè©±ã³ã³ããã¹ã確èªïŒçŽåã®è°è«ããæœåº or æ°èŠãã¢ãªã³ã°ïŒ
äœãäœããèãïŒmax 3åïŒ
èšç»å質ãã§ã㯠ïŒææ°æ
å ±ãæ¢åä»æ§ãèšæ¶ãTeamAgent / ãµããšãŒãžã§ã³ãè€æ°èŠç¹ã¬ãã¥ãŒãæ¡ç¹ïŒæè¡èª¿æ»ïŒWebSearchïŒ
æ©èœãªã¹ãæœåº
spec.md / Plans.md äºæ£æ¬ãã§ã㯠ïŒSpec delta ãŸã㯠Spec skip reason + Plans.md taskïŒåªå
床ãããªã¯ã¹ïŒRequired / Recommended / Optional / RejectïŒ
TDD æ¡çšå€æïŒãã¹ãèšèšïŒ
Plans.md çæïŒcc:TODO ããŒã«ãŒä»ãïŒ
äºå確èªã»ã¯ã·ã§ã³çæ ïŒplan-time pre-approvalïŒæ¬¡ã®ã¢ã¯ã·ã§ã³æ¡å
create â äºå確èªã»ã¯ã·ã§ã³ïŒplan-time pre-approvalïŒ create ã§èšç»ã確å®ããæã¯ãPlans.md task ãåºããããšãæ¿èªåã« äºå確èªã»ã¯ã·ã§ã³ ãå¿
ãçæããã
ç®çã¯ãåžžèš allowlist ã§äœã§ãèš±å¯ããã®ã§ã¯ãªããäœæ¥ã¹ã³ãŒãããšã«ãçºçããã㪠stop / askãã plan æ¿èªæã« 1 åã ãååãã§ç¢ºèªããããšã
å task ã®å¯Ÿè±¡ãã¡ã€ã«ãé¢é£ pathãæ³å®å€æŽç¯å²
DoD ã«æžããæ€èšŒã³ãã³ããPR closeout ã³ãã³ããå€éš API / CLI åŒã³åºã
secret-read pathïŒ.env*, secrets/**, *.pem, *.key, .ssh/**, .aws/**, credentials ãªã©ïŒå€éšéä¿¡ïŒgit push, gh pr create, gh api, curl / API call, release / publish / deployïŒ
ç Žå£çæäœïŒrm -rf, migration destructive step, force push, production applyïŒ
## äºå確èª
- äºé
: <secret-read / external-send / destructive ã®å
·äœæäœ>
çç±: <DoD ãŸã㯠task å®è¡äžå¿
èŠãªçç±ã 1 è¡>
scope: Phase <phase> / Task <task>
1 è¡ã® çç± ã¯ secret å€ãå«ããªããpath / ã³ãã³ãå / 察象ãµãŒãã¹ãŸã§ã«çããã
plan æ¿èªæã«ãäºå確èªã»ã¯ã·ã§ã³ã®å
šäºé
ãäžæ¬æ瀺ãããŠãŒã¶ãŒããæ¿èª / åŠèªãåŸãã
æ¿èªçµæ㯠.claude/state/plan-preapprovals.json ã« plan-preapproval.v2 ãšããŠèšé²ãããschema 㯠templates/schemas/plan-preapproval.v2.jsonãv1 ã¯æ¢åèšé²ã®èªã¿åãäºæã«éãã
èšé²ã¯ äºé
+ çç± 1 è¡ + scope (phase/task) ãç¶æãããoperations ã«ã¯ secret-read / external-send / destructive ãåæãããpaths / commands / targets ã«ã¯å¯Ÿè±¡ãåæãããdecisionãapproved_atãRFC3339 ã® expires_at ãå
¥ããã
max_uses ã¯å¿
èŠãªåè©Šè¡åæ°ãå«ãäžéãèšå®ãããçç¥æ㯠10 åãuses ã¯æ°èŠæ¿èªæã« 0 ãšããã確èªã¯ plan æ¿èªæã® 1 åã®ã¿ãharness-work / breezing å®è¡äžã宣èšæžã¿äºé
ã ããçç±ã« AskUserQuestion ãåºããŠã¯ãããªãã
èšé²ã«ç¡ãæªèšç»ã® secret-read / å€éšéä¿¡ / ç Žå£çæäœã¯ãåŸæ¥ã©ãã runtime floor / ask ã§åæ¢ãããå®å
šç¶²ãçããªãã
secret-read ã®æ¿èªã¯ secret å€ã®è¡šç€ºèš±å¯ã§ã¯ãªããå¿
èŠæå°ã® path ã宣èšããwork éå§æã« project config ã® runtimefloor.secretAllow ãž per-run åæ ããããã®å
¥åãšããŠæ±ãã
spec.md / Plans.md äºæ£æ¬ãã§ãã¯ïŒããã©ã«ãïŒ Plans.md ã¯ãããã¹ãããšãã® task contractãroot spec.md ã¯ãäœãæ£ããããã® product contract ãšããŠæ±ãã
co-required planning output ã¯äž¡æ¹ã®åºåãå¿
é ã«ãããšããæå³ã§ãããprecedence 㯠spec.md > sub-spec > Plans.md ã®ãŸãŸç¶æããã
å®è£
ãã¶ããå¯èœæ§ãããæã¯ãPlans.md çæåã« root spec.md ãæŽæ°ããã
create ãš product-impacting add ã¯æ¯å root spec.md ãèªãã
root spec.md
consumer repo ã« root spec.md ããªãæã ããæ¢åã® project spec / architecture / product compass
consumer repo ã« root spec.md ããªãæã ããdocs/spec/00-project-spec.md
æ¢åèŠçŽããã repo ã§ã¯ããã®èŠçŽã«æ²¿ã£ã spec path
äœæ/æŽæ°ãå¿
èŠãªæ¡ä»¶:
ãŠãŒã¶ãŒã«èŠããæ¯ãèããAPIãããŒã¿ã¢ãã«ãæš©éã課éãå€éšé£æºã決ãã task
è€æ°ã®å®è£
æ¹éããããéžã³æ¹ã§ product behavior ãå€ãã task
éå»ãŸãã¯ä»åã®äŒè©±ã§ãä»æ§ãææ§ã§å®è£
ãã¶ãããå
åããã task
Plans.md ã«ã¯äœæ¥å
容ãããããproject ãšããŠã®æ£è§£æ¡ä»¶ãå®å®ææžã«ãªã task
typoãformatãdependency bumpãREADME/CHANGELOG ã®ã¿
åäœå€æŽãªãã®çã refactor
æ¢å spec ãšãã¹ãã§æ£è§£ãååã«åºå®ãããŠããä¿®æ£
Spec delta: product contract ãæŽæ°ããæã«ã察象 spec path ãšå€æŽç¹ãæžãSpec skip reason: product contract ãæŽæ°ããªãæã«ãçç±ãæžãSpec delta / Spec skip reason 㯠Harness ãçæããconsumer ã¯æ¿èªã»ä¿®æ£ã ãè¡ãdocs-only / mechanical task ã§ã Spec skip reason ã task context / sprint contract ã«æ®ã
missing search resultãunavailable memoryãæªèªãã¡ã€ã«ã absent ãšæå®ããªããnot_observed != absent
ãŠãŒã¶ãŒã« spec ãäžããæžãããªããagent ãæ¢å spec ãšå
¥åããæå° delta ãäœããææ§ãªæã ãå€æåå²ãåºã
create å®äºæã®ã»ãã·ã§ã³èµ·åæ¡å
ïŒå¿
é ïŒ create ãçµãã£ããã説æã ãã§çµãããããæ°ããã»ãã·ã§ã³ã®èµ·åã³ãã³ã ãš
èµ·ååŸã«ãã®ãŸãŸå
¥ããæåã®æ瀺ããã³ãã ãã»ããã§æ¡å
ããã
åªå
é äœã¯æ¬¡ã®éã:
æªå®äºã¿ã¹ã¯ã 1 件ã ãããŸãã¯æåã® 1 件ã ãå§ããã®ãèªç¶
èµ·åã³ãã³ã: claude
æåã®å
¥å: /harness-work <taskçªå·>
äŸåã®èãã¿ã¹ã¯ãè€æ°ããããŸãšããŠé²ããã®ãèªç¶
èµ·åã³ãã³ã: claude
æåã®å
¥å: /breezing all
代æ¿: /harness-work all
é·æéå®è¡ãåå
¥ãåæ
èµ·åã³ãã³ã: ENABLE_PROMPT_CACHING_1H=1 claude
æåã®å
¥å: /harness-loop all
代æ¿: /breezing all
æäœã§ã次㮠3 è¡ãå«ãã:
æ°ããã»ãã·ã§ã³ã®èµ·åã³ãã³ã:èµ·ååŸã®æåã®å
¥å:åããŠããå Žé¢: æ°ããã»ãã·ã§ã³ã®èµ·åã³ãã³ã: claude
èµ·ååŸã®æåã®å
¥å: /breezing all
åããŠããå Žé¢: Phase 1 ã® task ãè€æ°ããããŸãšããŠé²ããã»ããèªç¶ãªãã
é·æéç³»ãå§ããå Žåã¯ãClaude Code ã»ãã·ã§ã³èµ·åã³ãã³ãã䜵èšãã:
æ°ããã»ãã·ã§ã³ã®èµ·åã³ãã³ã: ENABLE_PROMPT_CACHING_1H=1 claude
èµ·ååŸã®æåã®å
¥å: /harness-loop all
åããŠããå Žé¢: 5 åãè¶
ããåŸ
æ©ã resume ããŸããé·æéã¿ã¹ã¯ã®ãã
scripts/claude-longrun.sh ã¯ãã®ãªããžããªã®éçºè£å©ã¹ã¯ãªããã§ãplugin install åŸã® consumer ç°å¢ã«ã¯é
åžãããªããã®ãããconsumer åãæ¡å
ã§ã¯åžžã« ENABLE_PROMPT_CACHING_1H=1 claude ã® 1 è¡ã³ãã³ããåªå
ãã
ãªããžããªéçºäžã ãåçã®ã©ãããŒã䜿ãããå Žåãbash scripts/claude-longrun.sh ã¯ããŒã«ã« checkout äžã§ã¯å©çšããŠãã
CI ã¢ãŒã (--ci):
ãã¢ãªã³ã°ãªããæ¢åã® Plans.md ããã®ãŸãŸå©çšããŠã¿ã¹ã¯å解ã®ã¿è¡ãã
add â ã¿ã¹ã¯è¿œå Plans.md ã«æ°ããã¿ã¹ã¯ãè¿œå ããã
product-impacting ãªè¿œå ã§ã¯ãäžã®ãspec.md / Plans.md äºæ£æ¬ãã§ãã¯ãã«åŸã Spec delta ãŸã㯠Spec skip reason ãåºåããã
/harness-plan add ã¿ã¹ã¯å: 詳现説æ [--phase ãã§ãŒãºçªå·]
ã¿ã¹ã¯ã¯ cc:TODO ããŒã«ãŒã§è¿œå ãããã
update â ããŒã«ãŒæŽæ° ã¿ã¹ã¯ã®ã¹ããŒã¿ã¹ããŒã«ãŒãå€æŽããã
/harness-plan update [ã¿ã¹ã¯å|ã¿ã¹ã¯çªå·] [WIP|å®äº|blocked]
ã³ãã³ã ããŒã«ãŒ WIPcc:WIPå®äº / donecc:å®äºblockedblockedTODOcc:TODO
sync â é²æåæ å®è£
ç¶æ³ãš Plans.md ãç
§åããå·®åãæ€åºã»æŽæ°ããïŒPlans.md çŸç¶ååŸ â ãã©ãŒãããæ€åº â git ç¶æ³ååŸ â agent trace åæ â å·®åæ€åº â ããŒã«ãŒä¿®æ£ææ¡ â 次ã¢ã¯ã·ã§ã³æ瀺ïŒã
cc:å®äº ã¿ã¹ã¯ã 1 件以äžããã°ãèŠç©ãã粟床ã»ãããã¯åå ã»ã¹ã³ãŒãå€åãåæããã¬ããã¹ãã¯ãã£ããããã©ã«ã ON ã§å®è¡ããïŒsync --no-retro ã§ã¹ãããïŒã
Step 0-6 ã®å®å
šçã»harness-mem ãžã®èšé²æé 㯠references/sync.md ãåç
§ã
team mode / issue bridge Plans.md ã¯æ£æ¬ã®ãŸãŸç¶æããGitHub Issue é£æºã¯ opt-in ã® team mode ã ãã§äœ¿ãã
solo éçºã§ã¯ bridge ã䜿ããªã
team mode 㯠tracking issue ã 1 ã€äœãããã®é
äžã« task ããšã® sub-issue payload ã dry-run ã§çæãã
scripts/plans-issue-bridge.sh ã¯å®éã« GitHub ãæŽæ°ãããåžžã« dry-run ã® payload ãè¿ãPlans.md ãžã®å€æŽã¯ãã® bridge ã§ã¯è¡ããªã
named Plans è€æ°ã® Plans.md ã䜿ãå Žå㯠plans/manifest.json ãæ£æ¬ã«ããŠãååã§éžæããïŒ1 run ã§ã¯ 1 ã€ã® named plan ã ãã䜿ããlong-running / CI / issue bridge ã§ã¯ active pointer ã«é Œãã --plan <name> ãæž¡ããmanifest path 㯠project root çžå¯Ÿã®ã¿ïŒã
scripts/plan-registry.sh list
scripts/plan-registry.sh switch roadmap
scripts/plans-issue-bridge.sh --plan roadmap --format markdown
node scripts/generate-sprint-contract.js --plan roadmap 9.1.1
åç
§: docs/plans/named-plans.md
Plans.md ãã©ãŒãããèŠçŽ
ãã©ãŒããã 5 ã«ã©ã ïŒTask / å
容 / DoD / Depends / StatusïŒã® Markdown tableãDoD 㯠Yes/No å€å®ã§ããæ€èšŒå¯èœãª 1 è¡ïŒãããæãããã¡ãããšåããã¯çŠæ¢ïŒã
Depends 㯠-ïŒäŸåãªãïŒ/ ã¿ã¹ã¯çªå· / ã«ã³ãåºåãè€æ° / ãã§ãŒãºäŸåã®ãããããçæãã³ãã¬ãŒãå
šæïŒPurpose è¡å«ãïŒã¯
references/create.md ãåç
§ã
DoD / acceptance_criteria ã®æ¡ç¹èšèš DoD ã acceptance_criteria ãæžããšãã¯ããã¢ã«ãã€ãã®äººããã§ãã¯ãªã¹ãã§âÃãä»ããããããã§å€å®ããã
æ©æ¢°âÃã®åºïŒãã¹ãã»åæ°ã»exit codeïŒ/ LLM 芳ç¹æ¡ç¹ïŒæ§æã»èšŽæ±ã®ãã§ãã¯ãªã¹ãïŒ/ æ¬è³ª doc åç
§ïŒspec.mdã»decisions.md ã®è©²åœæ¡é
ïŒã®
3 å±€ã«ç¿»èš³ããèŠåŸãããã³ææ§åœ¢å®¹è©ïŒè¯ã/ã¡ãããšãã/ãããããã çïŒãæ€åºãããšãã®ç¿»èš³æé ã¯
references/criteria-design.md ãåç
§ã
TDD tags Plans.md ã® task ã«ã¯ãTDD å€å®ãæ瀺ããã¿ã°ãå
容ãŸã㯠DoD ã«æžããã
ã¿ã° æå³ tdd_required æšè«[tdd:required]ãã® task ã¯å
ã«å€±æãã¹ããæžãå¿
èŠããã true[tdd:skip:<reason>]ãã® task ã¯çç±ã€ã㧠TDD ãçç¥ãã false, skip_tdd_reason=<reason>
<reason> ã¯ç©ºã«ããªãã
äŸ: [tdd:skip:docs-only]ã[tdd:skip:no-test-framework-detected]ã
ã¿ã°ããªãå Žåã® tdd_required ã¯æ¬¡ã®é ã§æšè«ããã
Plans.md tag: [tdd:required] / [tdd:skip:<reason>]
files: src/, app/, cmd/, lib/, pkg/, internal/, go/ ãªã© source å®è£
ãå«ããªã required
TDD æšè«: docs-only ã test framework ãªããªã skip reason ãä»ã㊠not required
optional briefs / manifest harness-plan create ã¯ãå¿
èŠãªãšãã ã brief ãä»ããã
project spec SSOT 㯠project å
šäœã®æ£è§£æ¡ä»¶ãåºå®ããææžã§ãå¿
èŠæã ãäœã
UI ãå«ãã¿ã¹ã¯ã§ã¯ design brief
API ãå«ãã¿ã¹ã¯ã§ã¯ contract brief
brief ã¯ãäœãäœããããçãåºå®ããè£å©è³æã§ãPlans.md ã spec SSOT ã眮ãæããªã
skill frontmatter ã®äžèŠ§ã¯ scripts/generate-skill-manifest.sh 㧠machine-readable JSON ã«ã§ãã
docs/plans/briefs-manifest.mddocs/plans/spec-ssot.md
ããŒã«ãŒäžèŠ§ ããŒã«ãŒ æå³ pm:äŸé ŒäžPM ããäŸé Œæžã¿ cc:TODOæªçæ cc:WIPäœæ¥äž cc:å®äºWorker äœæ¥å®äº pm:確èªæžPM ã¬ãã¥ãŒå®äº blockedãããã¯äžïŒçç±ãå¿
ãèšèŒïŒ
èšç»ç¢ºå®åŸã®å°ç·ïŒéãšã³ãžãã¢åãèšç»æŠèŠïŒ Plans.md ãžã® task append ãå®äºããããéãšã³ãžãã¢ã®çºæ³šè
ãèšç»ãå€æã§ãããã
harness-plan-brief ãææ¡ãããããã¯ç解ã»éžæè¢ã»ãªã¹ã¯ã»åæ Œæ¡ä»¶ã 1 æã® HTML ã«
ãŸãšãããèšç»æŠèŠãç»é¢ã§ãå°éç¥èãªãã§èªãããå®è£
ã«å
¥ãåã®åæ圢æã«äœ¿ãã
é¢é£ã¹ãã«
harness-sync â å®è£
ãš Plans.md ãåæããharness-work â èšç»ããã¿ã¹ã¯ãå®è£
ããharness-plan-brief â èšç»æŠèŠ HTMLïŒéãšã³ãžãã¢åããèšç»ç¢ºå®æã«ææ¡ïŒharness-review â å®è£
ã®ã¬ãã¥ãŒharness-setup â ãããžã§ã¯ãåæå 