## Linked intent

Link the Issue or Discussion this PR implements.

- Issue / Discussion:
- Closes/Fixes/Resolves:

For non-trivial changes, open an Issue or Discussion before code review. Direct PRs are intended only for typo/docs fixes, small test-only changes, clearly scoped bug fixes, or maintainer-approved work.

## Problem

What problem does this solve?

## Why now

Why is this needed now?

## Existing options checked

Which existing options or current behavior did you check, and why are they insufficient?

## Alternatives considered

What alternatives did you consider?

## No-code alternative

What docs, configuration, process, or support change could solve this without code?

## Why code is needed

Why is a code change still needed after checking no-code options?

## Summary

Describe the change in 2-5 bullets.

-
-

## Type

Mark all that apply.

- [ ] docs
- [ ] deterministic core / `lib`
- [ ] prompt / orchestration
- [ ] init / harness
- [ ] schema / compatibility
- [ ] release / marketplace wiring
- [ ] tests
- [ ] fix
- [ ] refactor
- [ ] other

## Scope

In:
-

Out:
-

## Risk areas

Mark anything touched in this PR.

- [ ] public API
- [ ] dependency change
- [ ] CI/workflow change
- [ ] auth/security
- [ ] database/schema
- [ ] runtime behavior
- [ ] docs-only
- [ ] test-only
- [ ] `commands/signum.md`
- [ ] `commands/init.md`
- [ ] `agents/*`
- [ ] `lib/*`
- [ ] `lib/schemas/*`
- [ ] `.github/workflows/*`
- [ ] none of the above

## Docs impact

- [ ] no docs update needed
- [ ] `README.md` or `QUICKSTART.md` updated
- [ ] `AGENTS.md` updated
- [ ] `docs/how-it-works.md` or `docs/reference.md` updated
- [ ] `docs/SECURITY.md` updated
- [ ] follow-up docs work is needed

Docs / rationale:
-

## Validation / proof

- [ ] not applicable yet (explain below)
- [ ] targeted shell tests
- [ ] full test run
- [ ] eval / fixture run
- [ ] doc walkthrough
- [ ] command output
- [ ] other

Commands run:

```text
paste commands and relevant output here
```

## DCO / authorship

- [ ] Every commit in this PR is signed off (`git commit -s`) and complies with `DCO.md`

## Reviewer notes

Anything that needs special attention?
