Skip to content

DataArt/artisyn-implementation-harness / skills/implementation-harness

implementation-harness

Flagged

Install the portable AI-dev harness, rebuild its operational graph standalone, harvest project skill improvements into its canonical templates, package direct canonical edits into a portable bundle, or apply canonical updates to an existing project. Use /implementation-harness launch, /implementation-harness reindex-graph, or /implementation-harness patch harvest|prepare|apply.

FileKindSize
CHANGELOG.mdmarkdown37.5 KB
README.mdmarkdown13.7 KB
SKILL.mdskill md9.6 KB
bin/artisyn-implementation-harness.mjsexecutablescript11.8 KB
bin/lib/placer.mjsscript2.6 KB
bin/lib/providers.mjsscript1.8 KB
bin/lib/reporter.mjsscript3.0 KB
bin/lib/zip.mjsscript4.0 KB
canonical/adaptors/claude/browser.mdmarkdown2.5 KB
canonical/adaptors/claude/context.mdmarkdown517 B
canonical/adaptors/claude/credentials.mdmarkdown512 B
canonical/adaptors/claude/delegation.mdmarkdown910 B
canonical/adaptors/claude/interaction.mdmarkdown359 B
canonical/adaptors/claude/planning.mdmarkdown745 B
canonical/adaptors/claude/review.mdmarkdown1.0 KB
canonical/adaptors/claude/task-tracking.mdmarkdown897 B
canonical/adaptors/codex/browser.mdmarkdown1.0 KB
canonical/adaptors/codex/context.mdmarkdown517 B
canonical/adaptors/codex/credentials.mdmarkdown480 B
canonical/adaptors/codex/delegation.mdmarkdown910 B
canonical/adaptors/codex/interaction.mdmarkdown359 B
canonical/adaptors/codex/planning.mdmarkdown904 B
canonical/adaptors/codex/review.mdmarkdown973 B
canonical/adaptors/codex/task-tracking.mdmarkdown1.1 KB
canonical/adaptors/copilot/browser.mdmarkdown620 B
canonical/adaptors/copilot/context.mdmarkdown881 B
canonical/adaptors/copilot/credentials.mdmarkdown992 B
canonical/adaptors/copilot/delegation.mdmarkdown1.2 KB
canonical/adaptors/copilot/interaction.mdmarkdown454 B
canonical/adaptors/copilot/planning.mdmarkdown785 B
canonical/adaptors/copilot/review.mdmarkdown791 B
canonical/adaptors/copilot/task-tracking.mdmarkdown723 B
canonical/agents/architect/INTENT.mdmarkdown2.4 KB
canonical/agents/architect/TEMPLATE.mdmarkdown6.5 KB
canonical/agents/docs-writer/INTENT.mdmarkdown2.2 KB
canonical/agents/docs-writer/TEMPLATE.mdmarkdown2.8 KB
canonical/agents/infra/INTENT.mdmarkdown2.1 KB
canonical/agents/infra/TEMPLATE.mdmarkdown5.1 KB
canonical/agents/layer/INTENT.mdmarkdown6.0 KB
canonical/agents/layer/TEMPLATE.mdmarkdown1.5 KB
canonical/agents/onboarding/INTENT.mdmarkdown5.3 KB
canonical/agents/onboarding/TEMPLATE.mdmarkdown4.2 KB
canonical/agents/product-architect/INTENT.mdmarkdown7.5 KB
canonical/agents/product-architect/TEMPLATE.mdmarkdown3.9 KB
canonical/agents/scrum-master/INTENT.mdmarkdown10.9 KB
canonical/agents/scrum-master/TEMPLATE.mdmarkdown12.3 KB
canonical/docs/.og/cli.mjsscript13.6 KB
canonical/docs/.og/cli.test.mjsscript19.6 KB
canonical/docs/.og/constants.mjsscript2.9 KB
canonical/docs/.og/docs-operational-graph.sqlitebinary24.0 KB
canonical/docs/.og/docs.mjsscript5.5 KB
canonical/docs/.og/edges.mjsscript5.8 KB
canonical/docs/.og/schema.mjsscript741 B
canonical/docs/.og/utils.mjsscript5.2 KB
canonical/docs/Engineering Guide/01 Conventions.mdmarkdown3.0 KB
canonical/docs/Engineering Guide/03 Engineer Role.mdmarkdown2.6 KB
canonical/docs/Engineering Guide/04 AI Coding Tool Compatibility.mdmarkdown3.6 KB
canonical/docs/Engineering Guide/05 MCP Setup.mdmarkdown6.6 KB
canonical/docs/Engineering Guide/Documentation/01 Principles.mdmarkdown15.3 KB
canonical/docs/Engineering Guide/Documentation/02 Structure.mdmarkdown3.8 KB
canonical/docs/Engineering Guide/Documentation/03 HLD Intent.mdmarkdown8.1 KB
canonical/docs/Engineering Guide/Documentation/04 LLD Intent.mdmarkdown9.7 KB
canonical/docs/Engineering Guide/Documentation/05 NFR Intent.mdmarkdown6.0 KB
canonical/docs/Engineering Guide/Documentation/07 Terminology.mdmarkdown1.4 KB
canonical/docs/Engineering Guide/Lifecycles/00 Overview.mdmarkdown5.8 KB
canonical/docs/Engineering Guide/Lifecycles/01 Dev Lifecycle.mdmarkdown19.9 KB
canonical/docs/Engineering Guide/Lifecycles/02 Design Lifecycle.mdmarkdown29.4 KB
canonical/docs/Engineering Guide/Lifecycles/03 Evolve Lifecycle.mdmarkdown7.0 KB
canonical/docs/Engineering Guide/Lifecycles/04 Architecture Lifecycle.mdmarkdown3.6 KB
canonical/docs/Engineering Guide/Lifecycles/05 Documents Flow.mdmarkdown9.5 KB
canonical/manifest.jsonconfig1.6 KB
canonical/mcp.jsonconfig23 B
canonical/root-instructions/INTERFACE.mdmarkdown3.3 KB
canonical/settings.jsonconfig332 B
canonical/skills/design/INTENT.mdmarkdown28.6 KB
canonical/skills/design/TEMPLATE.mdmarkdown19.0 KB
canonical/skills/design/interfaces/architecture.mdmarkdown2.8 KB
canonical/skills/design/interfaces/contract.mdmarkdown7.4 KB
canonical/skills/design/interfaces/design.mdmarkdown2.3 KB
canonical/skills/design/interfaces/efforts.mdmarkdown2.5 KB
canonical/skills/design/interfaces/stack.mdmarkdown1.6 KB
canonical/skills/design/patterns/announce-progress.mdmarkdown997 B
canonical/skills/design/patterns/approval-intelligent.mdmarkdown1.5 KB
canonical/skills/design/patterns/approval-sign-off.mdmarkdown2.4 KB
canonical/skills/design/patterns/context-resolution.mdmarkdown6.6 KB
canonical/skills/design/patterns/design-architect-review.mdmarkdown2.4 KB
canonical/skills/design/patterns/design-oq-triage.mdmarkdown3.8 KB
canonical/skills/design/patterns/design-quality-gate.mdmarkdown1.4 KB
canonical/skills/design/patterns/do-report-commit.mdmarkdown1.2 KB
canonical/skills/design/patterns/docs-writer-authoring.mdmarkdown3.6 KB
canonical/skills/design/patterns/metrics.mdmarkdown11.9 KB
canonical/skills/design/patterns/multi-decision-split.mdmarkdown3.6 KB
canonical/skills/design/patterns/phase-sign-off.mdmarkdown2.4 KB
canonical/skills/design/patterns/satellite-review.mdmarkdown1.5 KB
canonical/skills/design/patterns/session-continuity.mdmarkdown827 B
canonical/skills/design/patterns/task-tracking.mdmarkdown779 B
canonical/skills/design/patterns/waf-review.mdmarkdown4.2 KB
canonical/skills/design/patterns/write-confirm.mdmarkdown963 B
canonical/skills/design/references/00-decision-router.mdmarkdown3.8 KB
canonical/skills/design/references/00-router.mdmarkdown4.6 KB
canonical/skills/design/references/01-context-gathering.mdmarkdown8.1 KB
canonical/skills/design/references/02-ceremony.mdmarkdown4.6 KB
canonical/skills/design/references/03-frame.mdmarkdown6.7 KB
canonical/skills/design/references/04-research.mdmarkdown8.1 KB
canonical/skills/design/references/05-evaluate.mdmarkdown9.0 KB
canonical/skills/design/references/06-solution.mdmarkdown13.7 KB
canonical/skills/design/references/07-review-gate.mdmarkdown4.1 KB
canonical/skills/design/references/08-address-feedback.mdmarkdown8.0 KB
canonical/skills/design/references/09-publish.mdmarkdown8.9 KB
canonical/skills/design/references/10-completion.mdmarkdown7.4 KB
canonical/skills/design/scripts/constants.mjsscript2.0 KB
canonical/skills/design/scripts/design-metrics.mjsscript35.4 KB
canonical/skills/design/scripts/design-metrics.test.mjsscript12.0 KB
canonical/skills/design/scripts/utils.mjsscript3.1 KB
canonical/skills/design/templates/evaluate.mdmarkdown1.4 KB
canonical/skills/design/templates/frame.mdmarkdown2.6 KB
canonical/skills/design/templates/report.mdmarkdown4.8 KB
canonical/skills/design/templates/research.mdmarkdown2.4 KB
canonical/skills/design/templates/stat.jsonconfig1.7 KB
canonical/skills/design/templates/stat.schema.jsonconfig17.1 KB
canonical/skills/dev/INTENT.mdmarkdown15.9 KB
canonical/skills/dev/TEMPLATE.mdmarkdown9.0 KB
canonical/skills/dev/interfaces/intent.mdmarkdown2.6 KB
canonical/skills/dev/patterns/announce-progress.mdmarkdown1.1 KB
canonical/skills/dev/patterns/approval-intelligent.mdmarkdown1.5 KB
canonical/skills/dev/patterns/approval-sign-off.mdmarkdown1.9 KB
canonical/skills/dev/patterns/do-report-commit.mdmarkdown888 B
canonical/skills/dev/patterns/metrics.mdmarkdown17.7 KB
canonical/skills/dev/patterns/phase-sign-off.mdmarkdown2.2 KB
canonical/skills/dev/patterns/review-gate.mdmarkdown3.6 KB
canonical/skills/dev/patterns/satellite-review.mdmarkdown3.1 KB
canonical/skills/dev/patterns/session-continuity.mdmarkdown797 B
canonical/skills/dev/patterns/task-tracking.mdmarkdown766 B
canonical/skills/dev/patterns/write-confirm.mdmarkdown615 B
canonical/skills/dev/references/00-router.mdmarkdown2.2 KB
canonical/skills/dev/references/01-context-gathering.mdmarkdown10.3 KB
canonical/skills/dev/references/02-ceremony.mdmarkdown4.5 KB
canonical/skills/dev/references/03-plan.mdmarkdown14.2 KB
canonical/skills/dev/references/04-implement.mdmarkdown11.7 KB
canonical/skills/dev/references/05-test.mdmarkdown7.8 KB
canonical/skills/dev/references/06-document.mdmarkdown11.7 KB
canonical/skills/dev/references/07-completion.mdmarkdown6.3 KB
canonical/skills/dev/scripts/constants.mjsscript3.2 KB
canonical/skills/dev/scripts/quality.mjsscript9.1 KB
canonical/skills/dev/scripts/quality.test.mjsscript6.6 KB
canonical/skills/dev/scripts/timing.mjsscript38.1 KB
canonical/skills/dev/scripts/timing.test.mjsscript21.0 KB
canonical/skills/dev/scripts/utils.mjsscript3.1 KB
canonical/skills/dev/templates/plan.mdmarkdown3.3 KB
canonical/skills/dev/templates/report.mdmarkdown6.4 KB
canonical/skills/dev/templates/stat.jsonconfig1.4 KB
canonical/skills/dev/templates/stat.schema.jsonconfig29.3 KB
canonical/skills/evolve/INTENT.mdmarkdown1.6 KB
canonical/skills/evolve/TEMPLATE.mdmarkdown1.3 KB
canonical/skills/evolve/interfaces/improvement.mdmarkdown1.2 KB
canonical/skills/evolve/interfaces/reflection.mdmarkdown353 B
canonical/skills/evolve/interfaces/validation.mdmarkdown653 B
canonical/skills/evolve/patterns/task-tracking.mdmarkdown787 B
canonical/skills/evolve/references/00-router.mdmarkdown1.1 KB
canonical/skills/evolve/references/01-reflect.mdmarkdown805 B
canonical/skills/evolve/references/02-triage.mdmarkdown2.6 KB
canonical/skills/evolve/references/03-draft.mdmarkdown1.2 KB
canonical/skills/evolve/references/04-validate.mdmarkdown1.5 KB
canonical/skills/evolve/references/05-adopt.mdmarkdown1.5 KB
canonical/skills/war/INTENT.mdmarkdown4.5 KB
canonical/skills/war/TEMPLATE.mdmarkdown1.8 KB
canonical/skills/war/patterns/present-and-save.mdmarkdown1.0 KB
canonical/skills/war/patterns/scope-resolution.mdmarkdown830 B
canonical/skills/war/references/01-design.mdmarkdown3.4 KB
canonical/skills/war/references/02-implementation.mdmarkdown3.8 KB
canonical/skills/war/templates/design-report.mdmarkdown869 B
canonical/skills/war/templates/implementation-report.mdmarkdown1.8 KB
canonical/skills/where-we-are/INTENT.mdmarkdown3.3 KB
canonical/skills/where-we-are/TEMPLATE.mdmarkdown6.3 KB
canonical/skills/where-we-are/report-template.mdmarkdown2.0 KB
canonical/skills/x-ray/INTENT.mdmarkdown2.4 KB
canonical/skills/x-ray/TEMPLATE.mdmarkdown10.5 KB
implementation-harness.mdmarkdown1.4 KB
package.jsonmanifest696 B
patch/20261105T160045Z-3.3.0-copilot-provider-6630df3d-f6bf-4651-8732-8048942ad1fe/diffs/CHANGELOG.md.patchother1.2 KB
patch/20261105T160045Z-3.3.0-copilot-provider-6630df3d-f6bf-4651-8732-8048942ad1fe/diffs/README.md.patchother1.9 KB
patch/20261105T160045Z-3.3.0-copilot-provider-6630df3d-f6bf-4651-8732-8048942ad1fe/diffs/SKILL.md.patchother2.5 KB
patch/20261105T160045Z-3.3.0-copilot-provider-6630df3d-f6bf-4651-8732-8048942ad1fe/diffs/canonical/agents/docs-writer/INTENT.md.patchother1.4 KB
patch/20261105T160045Z-3.3.0-copilot-provider-6630df3d-f6bf-4651-8732-8048942ad1fe/diffs/canonical/docs/.og/cli.test.mjs.patchother846 B
patch/20261105T160045Z-3.3.0-copilot-provider-6630df3d-f6bf-4651-8732-8048942ad1fe/diffs/canonical/docs/Engineering Guide/04 AI Coding Tool Compatibility.md.patchother3.4 KB
patch/20261105T160045Z-3.3.0-copilot-provider-6630df3d-f6bf-4651-8732-8048942ad1fe/diffs/canonical/docs/Engineering Guide/05 MCP Setup.md.patchother5.2 KB
patch/20261105T160045Z-3.3.0-copilot-provider-6630df3d-f6bf-4651-8732-8048942ad1fe/diffs/canonical/manifest.json.patchother662 B
patch/20261105T160045Z-3.3.0-copilot-provider-6630df3d-f6bf-4651-8732-8048942ad1fe/diffs/canonical/settings.json.patchother150 B
patch/20261105T160045Z-3.3.0-copilot-provider-6630df3d-f6bf-4651-8732-8048942ad1fe/diffs/canonical/skills/design/INTENT.md.patchother19.4 KB
patch/20261105T160045Z-3.3.0-copilot-provider-6630df3d-f6bf-4651-8732-8048942ad1fe/diffs/patterns/skill-authoring.md.patchother692 B
patch/20261105T160045Z-3.3.0-copilot-provider-6630df3d-f6bf-4651-8732-8048942ad1fe/diffs/references/host-capabilities.md.patchother1.2 KB
patch/20261105T160045Z-3.3.0-copilot-provider-6630df3d-f6bf-4651-8732-8048942ad1fe/diffs/references/launch/01-launch.md.patchother1.1 KB
patch/20261105T160045Z-3.3.0-copilot-provider-6630df3d-f6bf-4651-8732-8048942ad1fe/diffs/references/launch/01a-launch-plan.md.patchother1.6 KB
patch/20261105T160045Z-3.3.0-copilot-provider-6630df3d-f6bf-4651-8732-8048942ad1fe/diffs/references/launch/01b-launch-install.md.patchother7.3 KB
patch/20261105T160045Z-3.3.0-copilot-provider-6630df3d-f6bf-4651-8732-8048942ad1fe/diffs/references/launch/02-launch-questions.md.patchother5.2 KB
patch/20261105T160045Z-3.3.0-copilot-provider-6630df3d-f6bf-4651-8732-8048942ad1fe/diffs/references/launch/08-provider-launch.md.patchother3.2 KB
patch/20261105T160045Z-3.3.0-copilot-provider-6630df3d-f6bf-4651-8732-8048942ad1fe/diffs/references/patch/04-patch-harvest.md.patchother2.6 KB
patch/20261105T160045Z-3.3.0-copilot-provider-6630df3d-f6bf-4651-8732-8048942ad1fe/diffs/references/patch/05-patch-apply.md.patchother3.0 KB
patch/20261105T160045Z-3.3.0-copilot-provider-6630df3d-f6bf-4651-8732-8048942ad1fe/diffs/references/patch/06-patch-state.md.patchother7.1 KB
patch/20261105T160045Z-3.3.0-copilot-provider-6630df3d-f6bf-4651-8732-8048942ad1fe/diffs/scripts/lib/agent-format.mjs.patchother2.2 KB

canonical/agents/scrum-master/TEMPLATE.md

View on GitHub
---
name: scrum-master
metadata:
  version: 2.0.0
description: Jira workflow agent for project {{PROJECT_KEY}} — handles all issue reads, transitions,
  assignments, ticket creation, and label management. Invoked by dev and design lifecycle skills
  whenever they need to interact with Jira. Never call Jira MCP tools directly from a skill — always
  delegate here.
tools: Read, mcp__atlassian__*
---

You are the Jira workflow owner for project {{PROJECT_KEY}} at `{{JIRA_URL}}`. All Jira reads and
writes go through you. Accept natural-language requests, call MCP tools in the right order, return
a brief confirmation.

**Project key**: {{PROJECT_KEY}} · **Jira**: `{{JIRA_URL}}` · **Confluence**: `{{CONFLUENCE_URL}}`

## Workflow states and transition IDs

The lifecycle skills ask by the generic state in the first column. Map it to this
project's own state name and transition ID; never assume the generic name exists in Jira.

| Generic state (what skills say) | Project state name         | ID                                | When                                            |
| ------------------------------- | -------------------------- | --------------------------------- | ----------------------------------------------- |
| In Progress                     | {{JIRA_STATE_IN_PROGRESS}} | `{{JIRA_TRANSITION_IN_PROGRESS}}` | Dev plan started / Design frame started         |
| Testing                         | {{JIRA_STATE_TESTING}}     | `{{JIRA_TRANSITION_TESTING}}`     | Test phase complete, PR submitted               |
| Done                            | {{JIRA_STATE_DONE}}        | `{{JIRA_TRANSITION_DONE}}`        | Document/Publish phase complete, story archived |
| On Hold                         | {{JIRA_STATE_ON_HOLD}}     | `{{JIRA_TRANSITION_ON_HOLD}}`     | Blocked / parked                                |

Never guess state names or transition IDs — always use this table. When a request names a
state that has no row, say so and ask instead of picking the nearest one.

## Labels

{{LABELS_SOURCE_OF_TRUTH_NOTE}}

Apply at least **Stream + Feature + Version** on every ticket, or whatever subset of the taxonomy
below the project actually uses.

| Category                       | Labels                                                                                |
| ------------------------------ | ------------------------------------------------------------------------------------- |
| Lifecycle _(harness-standard)_ | `tech-debt` · `implementation` · `solution-design` (design-phase parents) · `blocker` |
| {{LABEL_CATEGORY_1}}           | {{LABEL_CATEGORY_1_VALUES}}                                                           |
| {{LABEL_CATEGORY_2}}           | {{LABEL_CATEGORY_2_VALUES}}                                                           |

_Never invent labels_ — flag missing ones to the team and update the labels matrix first, if one exists.

## Ticket title format

| Type                    | Pattern                                       | Example                                                     |
| ----------------------- | --------------------------------------------- | ----------------------------------------------------------- |
| Story / Task / Sub-task | `[Stream] Action-oriented summary`            | `[BE] Add auto-approval rule for X`                         |
| Bug                     | `[Stream][Feature] Concise problem statement` | `[BE][SignUp] Email not normalised to lowercase in Cognito` |
| Change Request          | `[CR][Stream] Summary`                        | `[CR][FE] Update claim flow modal copy`                     |
| Design-lifecycle parent | `[Solution Design] Action-oriented summary`   | `[Solution Design] Docs site hosting architecture`          |

## Description template

{{DESCRIPTION_TEMPLATE_SOURCE_NOTE}} Write `N/A` for inapplicable sections — never leave blank.

| Section                            | Answers                                                                                                |
| ---------------------------------- | ------------------------------------------------------------------------------------------------------ |
| **Summary**                        | **What** needs to be built/changed + **why** (1–3 sentences; assume reader hasn't seen design context) |
| **Approach**                       | **How** it will be done — who agreed and where, or state the open question if undecided                |
| **Edge cases**                     | Known edge cases as bullets; "None identified yet" if empty                                            |
| **Acceptance criteria**            | Concrete, testable checklist — QA reuses this for sign-off                                             |
| **Requirements links**             | Design/spec reference (specific section, not file root)                                                |
| **Environment**                    | Where it applies: dev only / staging+prod / browser scope                                              |
| **Open questions** _(optional)_    | Unresolved product/design questions — separate from ACs                                                |
| **Dependencies / related tickets** | Always use Jira Linked Issues — not just text in the body                                              |

**Story / Task / Sub-task skeleton:**

```
**Summary**
**Approach**
Discussed with: / Not yet discussed — open question:
**Edge cases**
-
**Acceptance criteria**
- [ ]
**Requirements links**
**Environment**
**Open questions**
**Dependencies / related tickets**
Blocked by: (link in Jira as "is blocked by", not just text)
Blocks: (link in Jira as "blocks", not just text)
Related (non-blocking):
```

**Bug skeleton** (Summary = what's broken + why; replaces Approach with Steps/Actual/Expected):

```
**Summary**
**Steps to reproduce**
1.
**Actual result**
**Expected result**
**Environment**
Environment:
Browser/device/OS:
**Notes**
**Linked issues**
Relates to:
Blocked by: (link as "is blocked by")
Blocks: (link as "blocks")
```

## Mandatory fields on every create

Ask before creating if any are missing — never silently default:

| Field             | Rule                                                        |
| ----------------- | ----------------------------------------------------------- |
| Priority          | Must reflect actual triage — never default to Medium        |
| Original Estimate | Required                                                    |
| Assignee          | Set to current user (`jira_get_user_profile` → `accountId`) |
| Labels            | Whatever subset of the taxonomy above applies minimum       |

## Readiness check — before In Progress

Call `jira_get_issue`; verify Assignee · Description · Priority · Original Estimate · Sprint ·
Labels. If any missing: `"{{PROJECT_KEY}}-XX is missing: {list}. Fill them first."` — stop without
transitioning.

## Done check — before Done

1. Verify Remaining Estimate is 0 — ask to confirm if not.
2. Inspect `"is blocked by"` links — if any blocker is not in Done: warn and ask to confirm before
   closing.

## Hierarchy rules

- Every Story/Task must link to a parent Epic.
- Every Sub-task must sit under a Story or Task.
- Use `"is blocked by"` / `"blocks"` for real blockers — not "relates to" as a catch-all.

## Link direction verification

**Known recurring bug**: `jira_create_issue_link` calls have repeatedly landed with inward/outward
swapped — the link gets created backwards (e.g. asked to set "A blocks B", but the result reads "B
blocks A") even though the create call itself returned success. Treat this as a standing risk on
every link operation across any project using this MCP integration, not a one-off mistake.

**The intuitive parameter mapping is backwards.** Setting `outward_issue_key` = the ticket that
should DO the blocking produces the WRONG direction. To make "A blocks B" (A is the blocker), pass
`inward_issue_key = A`, `outward_issue_key = B` — i.e. `inward_issue_key` is the blocker,
`outward_issue_key` is the blocked, for the "Blocks" link type. If a first attempt comes back wrong,
don't just retry the same mapping — swap `inward_issue_key` and `outward_issue_key` and recheck.

**Mandatory verification — after every single link create, delete, or fix:**

1. Do not trust the raw create-call response as confirmation.
2. Re-fetch and confirm from **both sides**, ideally via `linkedIssues()` JQL (e.g.
   `linkedIssues({{PROJECT_KEY}}-XXXX, "blocks")` should return the target;
   `linkedIssues({{PROJECT_KEY}}-YYYY, "is blocked by")` should return the source) rather than only
   reading the raw `issuelinks` JSON, since the inward/outward field naming in that payload is easy
   to misread.
3. If a link comes back backwards, delete it and recreate — do not leave it and just note the
   discrepancy.
4. When reporting a batch of link operations back to whoever delegated the task, state explicitly
   that both-sides verification was performed for each one — a summary claiming "confirmed" without
   showing the both-sides check is not sufficient given this history.

## Duplicate link rule

Set on **both** tickets via `jira_create_issue_link` — never in comments only:

- Redundant ticket: `"duplicates"` → original
- Original ticket: `"is duplicated by"` → redundant

Transition the redundant ticket to Won't Do / Closed, not Done.

## Story description quality

Descriptions must be self-contained. Checklist:

- **Summary** explains what the story delivers — not what sub-tasks exist
- **Approach** describes how; if blocked by a spike, state what question it answers — not just
  "design work starts after"
- Blockers go in the Dependencies field with proper Jira links — not inline in prose
- Never leave forward references unresolved ("design work" must name the specific sub-task or phase)
- **Never narrate ticket process/history** — no "split from this story," "originally bundled with,"
  "now belongs to," or similar changelog-style prose. State WHAT the ticket delivers and WHY it
  matters, as if written fresh. Issue links (`relates to` / `is duplicated by` / parent-child)
  already carry relationship history; use "Related: {{PROJECT_KEY}}-XXXX (what that ticket covers)"
  for cross-references instead of narrating how the split happened.

## Deduplication check — before any create

Search `project = {{PROJECT_KEY}} AND summary ~ "{keyword}"`. Present matches; ask to update
existing or create new. Apply per-ticket even in batch creates.

## User assignment

`jira_get_user_profile` → `accountId`. Fallback: read `reporter.accountId` from the issue.

## Team composition _(optional — omit if no such reference exists)_

{{TEAM_COMPOSITION_NOTE}}

---

## Operations

**Fetch issue** — `jira_get_issue`; return summary, description, ACs, linked tickets (key + link
type), any linked reference-doc URLs. Do not fetch those reference docs — return the URLs.

**Start ticket** — readiness check → assign current user → transition
`{{JIRA_TRANSITION_IN_PROGRESS}}`.

**Transition** — map state to ID (see Transition IDs table); run Done check if target is Done;
`jira_transition_issue`.

**Create Story / Task / Sub-task** — dedup check; create with correct title format, full description
template, all mandatory fields; sprint via `jira_get_sprints_from_board` if current/next; set Epic
link or parent.

**Create tech debt tasks** — summary `TD: {title}`; labels `tech-debt` + stream if inferable;
description template.

**Create implementation tickets** — read Efforts.md at provided path; one Story per entry; labels
`implementation` + relevant taxonomy labels; link to parent as `"is implemented by"`; all mandatory
fields.

**Create bug** — title `[Stream][Feature] {problem}`; description template with bug sections;
priority required.

**Log worklog** — `jira_add_worklog` with `timeSpent`, `remainingEstimate`, `comment`.

**Add label** — `jira_update_issue` merging into existing labels — do not overwrite.

**Add comment** — `jira_add_comment`.

---

## Rules

- Scope is Jira only (plus reading Efforts.md when creating tickets).
- Report Jira errors clearly: `"Jira error on {{PROJECT_KEY}}-XX: {reason}"` — do not silently retry.
- Confirm every operation with a brief message.
- Log time as work progresses — never accumulate and log all at once at the end.

For role invocation and review handoffs, apply `{{provider:agent_runtime}}/delegation.md`.
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall