SpecsCLIIP-157-curated-opensrc-example-repositories
Implementation Notes
Implementation Notes
Summary
- Implementing curated opensrc example repository metadata for framework packs, seeded only for the Effect pack.
Execution Mode
- sequential
Deviations From the Plan
- Fixed a pre-existing
bun run checklint blocker in the neutral subagent sync script and bundled source mirror because it blocked the repo-wide validation gate.
Surprises and Decisions
- Effect versions were read from cloned manifests/catalogs:
AnswerOverflow/AnswerOverflow:^3.20.0rhyssullivan/executor:4.0.0-beta.59alchemy-run/alchemy-effect:>=4.0.0-beta.66 || >=4.0.0anomalyco/opencode:4.0.0-beta.65pingdotgg/t3code:4.0.0-beta.59
Sanity Checks
| Check | Result | Notes |
|---|---|---|
bun run --filter @punks/scaffold test | Passed | T1 schema tests passed. |
bun run --filter @punks/cli test -- src/content/content.test.ts | Passed | T2 catalog/helper tests passed. |
bun run --filter @punks/cli test -- src/content/content.test.ts src/scaffold/run.test.ts | Passed | T3 prompt/scaffold output tests passed after formatting. |
jq empty apps/wiki/content/docs/cli/meta.json apps/wiki/content/docs/project/meta.json | Passed | T4 Fumadocs metadata is valid JSON. |
git diff --check | Passed | T4 whitespace check passed. |
bun run check | Passed | Oxlint and oxfmt check passed. |
bun run check-types | Passed | Root typecheck passed. |
bun run test | Passed | Root test suite passed. |
Acceptance Criteria Status
| Criterion | Status | Notes |
|---|---|---|
| Pack metadata can represent curated example repositories. | Met | @punks/scaffold schema decodes minimal curated example metadata. |
| Effect pack includes all five curated repositories with manifest-derived versions. | Met | Versions came from cloned repository package manifests/catalogs. |
| Scoped/workspace guidance emits selected-pack example guidance. | Met | Effect workspace prompts and prompt specs list curated repos with opensrc path owner/repo. |
| Docs/wiki capture the implemented contract. | Met | Existing concept pages now describe implemented scoped prompt/spec behavior. |
| Review, validation, and Linear closeout complete. | Met | Local review completed, validation passed, and Linear IP-158/IP-161/IP-159/IP-160/IP-157 are Done. |
Manual Review Checklist
| Area | Check | How to perform | Expected result |
|---|---|---|---|
| CLI scaffold prompts | Inspect generated Effect workspace prompt spec. | Run the focused scaffold/content tests listed in the final report, or inspect a generated .devpunks/specs/prompts/* file for an Effect workspace. | It lists curated repos with opensrc path owner/repo and explains they are examples for real-world patterns and architectures. |
Pre-existing Issues
- None identified.
Out of Scope Observations
- The no-useless-spread lint issue in
sync-subagents.mjswas pre-existing but fixed because it blocked repo-wide validation.
Remaining Work
- None.
Steering
| Date | Feedback | Changes |
|---|---|---|
| 2026-05-14 | User requested full IP-157 delivery through delivery-phase. | Created spec, plan, and sequential implementation notes. |