---
name: hforge-decide
description: create or update durable asr or adr records for harness forge workspaces. use when an analysis or implementation choice changes runtime behavior, package boundaries, support posture, migration strategy, or any other architecture-significant concern that should remain reviewable after the current session.
HForge Decide
Trigger Signals
an analysis or implementation choice has architecture-significant consequences
the repo already has decision records and the new work should link to them
multiple credible options exist and the rationale should stay durable
a task pack, impact analysis, or review surfaced a decision candidate that should not stay implicit
Inspect First
.hforge/runtime/decisions/index.json
.hforge/runtime/tasks/
.hforge/runtime/findings/
.hforge/runtime/repo/recommendations.json
the most relevant existing ASR or ADR if one already exists
Workflow
frame the decision clearly before writing anything
inspect related task packs, impact analysis, risk signals, and existing decision records
create an ASR when the direction is still being evaluated and an ADR when the decision is accepted enough to guide future work
write the record under .hforge/runtime/decisions/ with context, decision, consequences, constraints, risks, and follow-up actions
update supersession or related-record links when the new decision changes an earlier one
Output Contract
a concise ASR or ADR with explicit status and rationale
links to related tasks, impacts, and superseded records
follow-up actions or open questions when the work is not fully settled
1---2name: hforge-decide3description: ---4---5---6name: hforge-decide7description: create or update durable asr or adr records for harness forge workspaces. use when an analysis or implementation choice changes runtime behavior, package boundaries, support posture, migration strategy, or any other architecture-significant concern that should remain reviewable after the current session.8---910# HForge Decide1112## Trigger Signals1314- an analysis or implementation choice has architecture-significant consequences15- the repo already has decision records and the new work should link to them16- multiple credible options exist and the rationale should stay durable17- a task pack, impact analysis, or review surfaced a decision candidate that should not stay implicit1819## Inspect First2021- `.hforge/runtime/decisions/index.json`22- `.hforge/runtime/tasks/`23- `.hforge/runtime/findings/`24- `.hforge/runtime/repo/recommendations.json`25- the most relevant existing ASR or ADR if one already exists2627## Workflow28291. frame the decision clearly before writing anything302. inspect related task packs, impact analysis, risk signals, and existing decision records313. create an ASR when the direction is still being evaluated and an ADR when the decision is accepted enough to guide future work324. write the record under `.hforge/runtime/decisions/` with context, decision, consequences, constraints, risks, and follow-up actions335. update supersession or related-record links when the new decision changes an earlier one3435## Output Contract3637- a concise ASR or ADR with explicit status and rationale38- links to related tasks, impacts, and superseded records39- follow-up actions or open questions when the work is not fully settled4041## Validation Path4243- `.hforge/runtime/decisions/index.json`44- `schemas/runtime/decision-record.schema.json`45- `schemas/runtime/architecture-significance.schema.json`4647## Failure Modes4849- the real decision is still too vague to record50- there is not enough evidence to justify a durable record yet51- the new record conflicts with an existing one and the supersession path is unclear5253## Escalation5455- escalate when the decision changes public support or target guarantees56- escalate when migration or rollback cost is materially different across options57- escalate when a new record would contradict an existing accepted ADR5859## References6061- `skills/hforge-decide/references/decision-rubric.md`62- `skills/hforge-decide/references/output-contract.md`
Run npx skillmds@latest add ldilov/hforge-decide in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.
--- It is listed under Coding & Dev Tools on SkillMD.
This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.
This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.
Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.
ldilov (@ldilov) published this skill. Their other Agent Skills are listed on their SkillMD profile.
ldilov