mcpField
R
rs-shared

rs-shared

github.com/rootspecDevelopment057 installsUpdated 27w ago
Repository

About rs-shared

rs-shared is a shared resource package for the RootSpec skills and is not intended to be invoked directly. It provides project and specification scanning, validation, initialization, implementation, and test-support scripts alongside framework files and reference fragments.

Key features

  1. 01Project and specification scanning scripts
  2. 02Six-check specification validation
  3. 03Initialization and upgrade support
  4. 04Implementation and Cypress test helpers
  5. 05Shared framework files and guidance fragments

Use cases

  1. 01Scan a project for framework and configuration details
  2. 02Validate specification structure and coverage
  3. 03Prepare initialization or framework upgrades
  4. 04Generate and report Cypress test results

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/rootspec/rootspec --skill rs-shared

After installing, type/rs-sharedin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

00.AXIOMS.md
00.FRAMEWORK.md
README.md
cypress/
rootspec-reporter.ts
fragments/
anti-patterns.md
conventions.md
framework-rules.md
interview-protocol.md
l5-test-dsl.md
l5-yaml-format.md
prerequisites.md
test-runner-contract.md
scripts/
assess.sh
bootstrap-init.sh
build-tests-status.sh
check-app-ready.sh
check-coverage.sh
check-duplicate-ids.sh
check-hierarchy.sh
check-numerics.sh
check-pillar-quality.sh
check-tradeoffs.sh
check-vacuous-assertions.sh
compare-test-runs.sh
compute-spec-hash.sh
detect-prerequisites.sh
detect-stack.sh
dev.sh
filter-stories.sh
gap-analysis.sh

Details

From the project README

This skill contains shared resources for all RootSpec skills. Do not invoke directly.

Skills

SkillPurposeMode
/rs-initInitialize project — directories, base files, prerequisitesInteractive
/rs-specCreate or update specification — interview + validation loopInteractive (skippable)
/rs-implImplement from spec — test-driven, autonomousNon-interactive
/rs-validateRun tests and report resultsNon-interactive
/rs-updateUpgrade project to latest framework versionInteractive

Scripts

Project scanning
  • scripts/scan-spec.sh — Find spec directory, list found/missing files, detect version
  • scripts/scan-project.sh — Detect framework, source dirs, config files
Spec validation
  • scripts/validate-spec.sh — Run all 6 validation checks in one call (hierarchy, numerics, duplicate IDs, pillar quality, tradeoffs, coverage)
  • scripts/check-hierarchy.sh — Find downward references across spec levels
  • scripts/check-numerics.sh — Find hardcoded numbers in L1-L4
  • scripts/check-duplicate-ids.sh — Find duplicate story IDs in L5
  • scripts/check-pillar-quality.sh — Check L1 pillar count and format
  • scripts/check-tradeoffs.sh — Check L2 for explicit trade-off statements
  • scripts/check-coverage.sh — Cross-reference L4 systems with L5 stories
  • scripts/compute-spec-hash.sh — Compute deterministic hash of all spec files
Initialization and upgrade
  • scripts/detect-prerequisites.sh — Detect dev server, hooks, release/test scripts
  • scripts/verify-init.sh — Check all expected init files exist
  • scripts/gap-analysis.sh — Compare project version against bundled framework version
Implementation support
  • scripts/assess.sh — Front-load all reading for rs-impl in one call (spec, project, stories, conventions, fragments)
  • scripts/scaffold-cypress.sh — Create all Cypress infrastructure files in one call (config, support, DSL, reporter)
  • scripts/generate-test-file.sh — Build Cypress test file from spec YAML (embeds stories with loadAndRun pattern)
  • scripts/init-conventions.sh — Extract conventions from package.json, tsconfig, Tailwind config, and source code
  • scripts/generate-test-report.sh — Parse tests-status.json into formatted pass/fail/not-tested report
Stories and testing
  • scripts/filter-stories.sh — Filter L5 stories by ID, system, priority, or status
  • scripts/parse-cypress-results.sh — Parse Cypress JSON output to story/criterion results
  • scripts/build-tests-status.sh — Merge test results into tests-status.json
  • scripts/compare-test-runs.sh — Diff two test runs, report regressions/fixes

Bundled Files

  • 00.AXIOMS.md — Foundational beliefs (copied to user projects by rs-init)
  • 00.FRAMEWORK.md — Framework definition (copied to user projects by rs-init)

Fragments

  • fragments/framework-rules.md — Reference hierarchy and placeholder rules
  • fragments/interview-protocol.md — Interview methodology
  • fragments/anti-patterns.md — Common anti-patterns by level
  • fragments/prerequisites.md — Prerequisite detection and creation
  • fragments/l5-yaml-format.md — YAML syntax for user stories and fine-tuning
  • fragments/l5-test-dsl.md — Test DSL step reference and extensions

Comments

Markdown supported