Skip to content

feat: roadmap page + skills.sh integration + READMEs republish prep#2

Merged
Blockchain-Oracle merged 3 commits into
mainfrom
feature/roadmap-page
Jun 3, 2026
Merged

feat: roadmap page + skills.sh integration + READMEs republish prep#2
Blockchain-Oracle merged 3 commits into
mainfrom
feature/roadmap-page

Conversation

@Blockchain-Oracle
Copy link
Copy Markdown
Owner

Summary

Three landings in one PR (small, contained, easy to review):

1. /docs/roadmap page

  • New apps/site/content/docs/roadmap.mdx — what's next per surface (conditions, storage, adapters, templates, forms, dashboard, agent kit, Story IP, distribution, perf/DX).
  • Three confidence tags: next · queued · exploring.
  • Mainnet is explicitly out of scope until Story promotes CDR off testnet.
  • New <RoadmapTable> component with status-coded left borders, anchor links per row, 2-col grid on ≥720px → 1-col below. Registered in lib/mdx-components.tsx.
  • Sidebar entry under Getting started.

2. skills.sh integration (Vercel Agent Skills)

  • All 11 SKILL.md files copied to repo-root /skills/ so the skills.sh CLI can discover them. Originals at packages/plugin/cdr-kit/skills/ are untouched — cdr skill install continues to work.
  • Each description: rewritten to Vercel-style numbered triggers (Use this skill when (1)… (2)… (3)… (4)…).
  • README.md + packages/plugin/README.md now show the npx skills add Blockchain-Oracle/cdr-kit install line.
  • /docs/skill gets a 4th install path + a Callout explaining how the CLI packages cdr-kit (one repo = one skill package; subdirectories = individual skills; --skill <name> picks subsets).

Validated live against the published feature branch:

$ npx -y skills add Blockchain-Oracle/cdr-kit@feature/roadmap-page --list
◇ Found 12 skills
  audit-vault-config
  debug-cdr-precompile
  design-condition
  design-deadman-switch
  design-escrow
  design-multisig-condition
  design-publish-with-story
  design-storage-adapter
  design-time-window
  explain-cdr-error
  wire-allocate-pay-read

3. README republish prep — bump 14 packages

The READMEs on npm are still the old short ones because each package's last published version pre-dates the README rewrite. Diff between source and npm:

Package source npm gap
@cdr-kit/cli 4886 b 29 b 4857 b
@cdr-kit/agent 3790 b 1657 b 2133 b
@cdr-kit/react 4544 b 1229 b 3315 b
…11 more in the same shape

Patch-bumped each + single changeset .changeset/readmes-republish.md. After this PR merges, pnpm release flushes all 14 with byte-identical dists; only the README in each tarball updates.

Test plan

  • pnpm install, pnpm typecheck — clean
  • pnpm dev/docs/roadmap renders, sidebar entry present, all status pills color-coded
  • pnpm dev/docs/skill renders, new install path visible
  • npx skills add Blockchain-Oracle/cdr-kit --list discovers all 11 skills on the branch
  • Vercel preview deploys this branch (this is the reason this is a PR, not a direct push)
  • After merge: pnpm release flushes 14 republished packages with new READMEs

🤖 Generated with Claude Code

ajweb3dev and others added 3 commits June 3, 2026 19:19
…blish prep

Three landings in one branch (small, contained, easy to review):

**1. /docs/roadmap page**
   - New `apps/site/content/docs/roadmap.mdx` covering condition contracts,
     storage adapters, framework adapters, scaffolder templates, forms, dashboard
     surface, agent kit, Story IP integration, distribution, performance + DX.
   - Three confidence tags: next (current cycle), queued (1–2 cycles out),
     exploring (design not locked).
   - Mainnet is explicitly out of scope until Story promotes CDR off testnet.
   - New `<RoadmapTable>` component (`components/docs/roadmap-table.tsx` + .css)
     with status-coded left borders, anchor links per row, 2-col grid on
     ≥720px and 1-col below. Registered in `lib/mdx-components.tsx`.
   - Sidebar entry under "Getting started".

**2. skills.sh integration (Vercel Agent Skills)**
   - 11 SKILL.md files surfaced at repo-root `skills/` (via copy, with a
     source-of-truth comment pointing back at packages/plugin/cdr-kit/skills/).
     The original installer path `cdr skill install` continues to work
     unchanged — this is additive, not a replacement.
   - Every `description:` field rewritten to the Vercel-style numbered-trigger
     pattern (`Use this skill when (1)… (2)… (3)… (4)…`) so the cross-agent
     pattern-matcher reliably picks them up. Concrete trigger phrases mined
     from each skill body — see the subagent's report in the PR description
     for the full table.
   - README + plugin README now show:
     ```
     ## Use the skills from any agent (Claude Code · Cursor · Copilot · Cline · …)
     npx skills add Blockchain-Oracle/story-cdr
     ```

**3. README republish prep — bump 14 packages so pnpm release flushes**
   - The READMEs on npm are still the old short ones because each package's
     last published version pre-dates the README rewrite. Patch-bumped each:
       - cli, tools, mcp, react, react-ui, vercel-ai, openai, langchain,
         agentkit, goat: 0.7.0 → 0.7.1
       - agent, contracts, core, create-cdr-kit-app: 0.7.1 → 0.7.2
   - Single changeset `.changeset/readmes-republish.md` covers all 14. No
     code changes; the dists will be byte-identical. Only the README in each
     tarball updates.
   - Verified gap pre-bump: @cdr-kit/cli source=4886b vs npm=29b. Same shape
     across the other 13.

CI parity:
- pnpm install: clean
- pnpm typecheck: 24/24, 24.7s (first run, full)
- pnpm dev → /docs/roadmap renders, sidebar entry present, /skills/* surfaced

Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
Adds path #1 (skills.sh) above the existing cdr-kit-bundled paths and a
Callout explaining how the CLI bundles cdr-kit's 11 skills:

- One repo = one 'package' on skills.sh (Blockchain-Oracle/cdr-kit)
- Each subdirectory under /skills/ is one installable skill
- Default install pulls all 11; --skill <name> picks a subset; --all
  installs every skill into every detected agent
- Update everything later with npx skills update

Validated against the live skills CLI: `npx skills add
Blockchain-Oracle/cdr-kit --list` reports 'Found 12 skills' (the 11
skills + the root plugin manifest) on the feature/roadmap-page branch.
@vercel
Copy link
Copy Markdown

vercel Bot commented Jun 3, 2026

@ajweb3dev is attempting to deploy a commit to the blockchain-oracle's projects team on Vercel, but is not a member of this team. To resolve this issue, you can:

  • Make your repository public. Collaboration is free for open source and public repositories.
  • Upgrade to pro and add @ajweb3dev as a member. A Pro subscription is required to access Vercel's collaborative features.
    • If you're the owner of the team, click here to upgrade and add @ajweb3dev as a member.
    • If you're the user who initiated this build request, click here to request access.
    • If you're already a member of the blockchain-oracle's projects team, make sure that your Vercel account is connected to your GitHub account.

To read more about collaboration on Vercel, click here.

@chatgpt-codex-connector
Copy link
Copy Markdown

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.

@Blockchain-Oracle Blockchain-Oracle merged commit 8fb2f23 into main Jun 3, 2026
7 of 8 checks passed
@Blockchain-Oracle Blockchain-Oracle deleted the feature/roadmap-page branch June 3, 2026 18:29
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants