hero_service_scaffold: document docs/openrpc.json aggregate + per-domain (#274) #276

Merged

timur merged 1 commit from issue-274-multidomain-openrpc-docs into development

2026-05-20 08:16:43 +00:00

timur commented

2026-05-20 07:49:59 +00:00

Owner

Closes #274 (skill-doc half).

Summary

Adds docs/ to the generated workspace-layout tree in hero_service_scaffold.md.
Documents the two openrpc.json files emitted by hero_rpc#82 (now merged as PR #84): aggregate at docs/openrpc.json and per-domain at docs/<domain>/openrpc.json.
Notes that both files are always emitted (uniform layout) and explains which one each consumer uses (_admin → aggregate via <hero-api-docs>; _server → per-domain via include_str! for openrpc.discover).

No file-path references to the old src/<domain>/openrpc.json location were found anywhere in skills/hero/service/*.md, so no other docs needed touching.

Test plan

Doc-only change — visual review.
hero_service_check_fix.md searched for old src/<domain>/openrpc.json and core/openrpc.json refs — none present.

Follow-up

The hero_service template repo regeneration (issue #274 task B) is a separate push to its development branch, not a PR in this repo.

🤖 Generated with Claude Code

Closes #274 (skill-doc half). ## Summary - Adds `docs/` to the generated workspace-layout tree in `hero_service_scaffold.md`. - Documents the two openrpc.json files emitted by hero_rpc#82 (now merged as PR #84): aggregate at `docs/openrpc.json` and per-domain at `docs/<domain>/openrpc.json`. - Notes that both files are always emitted (uniform layout) and explains which one each consumer uses (`_admin` → aggregate via `<hero-api-docs>`; `_server` → per-domain via `include_str!` for `openrpc.discover`). No file-path references to the old `src/<domain>/openrpc.json` location were found anywhere in `skills/hero/service/*.md`, so no other docs needed touching. ## Test plan - [x] Doc-only change — visual review. - [x] `hero_service_check_fix.md` searched for old `src/<domain>/openrpc.json` and `core/openrpc.json` refs — none present. ## Follow-up The `hero_service` template repo regeneration (issue #274 task B) is a separate push to its `development` branch, not a PR in this repo. 🤖 Generated with [Claude Code](https://claude.com/claude-code)

timur added 1 commit

2026-05-20 07:49:59 +00:00

hero_service_scaffold: document docs/openrpc.json aggregate + per-domain (#274 ) 4185fe2177

Adds the `docs/` subtree to the generated workspace-layout block plus a
short paragraph describing the two files emitted per hero_rpc#82:

- `docs/openrpc.json` — aggregate across every domain (consumed by
  `<hero-api-docs>` in `_admin` via `include_str!`).
- `docs/<domain>/openrpc.json` — focused per-domain spec with
  `info.title` = `"<service>:<domain>"` (embedded by `_server` for
  `openrpc.discover`; static asset for single-domain SDK tooling).

Both files are always emitted so the layout is uniform between single-
and multi-domain services. Closes #274 (skill-doc half — the
`hero_service` template repo regeneration is a separate push).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

timur referenced this pull request

2026-05-20 07:50:04 +00:00

Update hero_service_scaffold skill + regenerate hero_service template repo for new docs/openrpc.json location #274

timur referenced this pull request

2026-05-20 07:53:18 +00:00

Update hero_service_scaffold skill + regenerate hero_service template repo for new docs/openrpc.json location #274

timur merged commit b20899bb5a into development

2026-05-20 08:16:43 +00:00

timur referenced this pull request from a commit

2026-05-20 08:16:44 +00:00

hero_service_scaffold: document docs/openrpc.json aggregate + per-domain (#274) (#276)

timur referenced this pull request