Skip to content

miklschmidt/archboard / skills/archboard-pr

archboard-pr

Verified

Help agents and humans understand architectural changes and choose meaningful PR boundaries. Use when creating PRs, updating PRs, or writing PR bodies, and load it together with any other PR skill, such as pr.

FileKindSize
SKILL.mdskill md8.2 KB
references/design.mdmarkdown1.6 KB
references/ephemeral.mdmarkdown2.2 KB
references/posting.mdmarkdown2.0 KB
references/reconcile.mdmarkdown1.4 KB
references/renders.mdmarkdown2.8 KB
references/split.mdmarkdown1.7 KB
references/walkthrough.mdmarkdown2.0 KB

references/ephemeral.md

View on GitHub
# Use a temporary model

Use a temporary model for an incidental flow or process that the repository does not need to retain.
Follow the consumer skill's ordinary authoring, claims, private history, and proposal recipes.
Keep output artifacts outside its vault and use `-C` on every model command.
The existing server serves this vault. Leave it running throughout this workflow.

Create the directory outside every source checkout:

```bash
pr_evidence_root=$(mktemp -d)
mkdir -p "$pr_evidence_root/.archboard/vault"
archboard model archive-init -C "$pr_evidence_root"
```

Initialize the planning model:

```bash
archboard model init --name 'Review evidence' --operation-id initialize-review --writer agent --doing 'Initialize review evidence' -C "$pr_evidence_root"
archboard model read -C "$pr_evidence_root"
```

Follow the consumer planning-root recipe. Even a single agent needs claims.
Read base code with `git show <base>:<path>` and head code from its actual source.

Bind modules to implementing repository identities and paths.
Describe base and proposed behavior through explicit independent or dependent states.
Preserve continuing IDs. Source implemented elsewhere does not turn a planning proposal into Current.
Do not adopt just to obtain comparison marks.

Use `model compare`, plus `model footprint` and `check code --state` where bindings support them.
Inspect skipped source directly.
Foreign bindings use registered chosen checkouts. Follow consumer setup rules before changing checkout selection.
For [renders](renders.md) and [walkthroughs](walkthrough.md), use their exact checkpoint recipes.

Keep SVG, PNG, video, talk files, and receipts until posting completes.
If the model needs a portable backup, use `model export`.
Standalone pictures and videos can be shared without publishing the archive.
For reproducible history, follow the parent skill's publication step and temporary state comment.

After preserving evidence, release claims and remove its temporary registration through `repo forget`.
Remove only inputs created by this workflow that no longer serve the task.
Keep private history and recovery files while pending operations or retained evidence need them.
Leave the repository's vault unchanged.
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: 472kUpdated 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