Skip to content

sandbaseai/workbuddy-skill / skills/architecture-decision

architecture-decision

Verified

Use when a technical choice changes system boundaries, contracts, quality attributes, data, or operations and has meaningful reversal cost.

Architecture Decision

Use this skill when a choice can alter boundaries, APIs, data ownership, deployment, security, reliability, performance, cost, or operational responsibility. Produce a decision that another engineer can verify and revisit; do not turn a tool preference into an architectural requirement.

Establish the decision frame

  1. State the decision to make and the deadline.
  2. Describe the current context, users, components, data flows, and relevant dependencies.
  3. Record constraints: compatibility, regulation, team capability, delivery window, budget, latency, availability, and migration limits.
  4. Identify up to five prioritized quality attributes and measurable targets (for example p95 latency, recovery time, availability, cost per request, or deploy frequency).
  5. List assumptions and missing evidence. If evidence is insufficient, record an investigation, owner, deadline, and decision criterion.

Do not claim a quality attribute without a measurement plan. Separate requirements from preferences and reversible experiments from durable commitments.

Compare options

Compare at least two viable alternatives and the option of not changing. For each, cover:

  • boundary and contract changes;
  • data ownership, consistency, migration, and rollback;
  • security, privacy, reliability, performance, and cost implications;
  • developer and operator experience, dependencies, and failure modes;
  • implementation effort, time to value, reversibility, and lock-in.

Use the same criteria for every option. Mark unknowns explicitly and distinguish evidence from judgment. A scorecard is useful only when its scale and weighting are explained; it must not hide a disqualifying risk behind an average score.

Record the decision

Write an ADR with: title, status, date, owners, context, decision drivers, considered options, decision, consequences, risks, mitigations, dependencies, operational impact, and links to evidence. State what is deliberately out of scope.

Define fitness functions that can be checked in CI, staging, or production: the metric, threshold, measurement source, sampling window, and owner. Include adoption steps, migration slices, compatibility period, data backfill or dual-write safeguards, cutover criteria, rollback trigger, and cleanup of temporary paths.

Govern the outcome

Before implementation, confirm affected teams, contracts, dashboards, alerts, runbooks, access controls, and support procedures. During rollout, use a canary or bounded cohort when risk warrants it; monitor correctness and user impact as well as technical metrics. Stop when a guardrail is breached or an assumption is disproven.

Set a review trigger: date, workload or dependency change, incident, metric regression, regulatory change, or expiry of an exception. Revisit the ADR when the trigger fires. Handoff the decision, evidence, owner, rollout state, unresolved risks, and next authorized action.

slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 194kUpdated Claude CodeCodexVerifiedInstall