runboard 0.1.0

package/AGENTS.md

@@ -0,0 +1,54 @@
+# Runboard for AI agents
+
+This file tells any AI agent (Claude, Cursor, Codex, Copilot, Gemini, ChatGPT, …) how to
+drive the `runboard` CLI on a user's behalf.
+
+## The one rule
+
+**The CLI computes; you converse.** Runboard's credibility depends on a deterministic
+core: all scores, averages, deltas, auto-triggers, and constraints are computed by the
+CLI. Your job is elicitation and interpretation — never calculate or invent a number.
+
+## What Runboard is
+
+A local-first maturity instrument scored on nine dimensions — Build / Run / Plan × Team /
+Tools / Techniques — each 1–5 with a trajectory (`up`/`flat`/`down`/`volatile`). Data
+lives in `.runboard/` in the user's repo. Nothing leaves the machine.
+
+## Commands you can run
+
+```bash
+runboard init                 # scaffold .runboard/ (idempotent)
+runboard assess --set <dim>=<level>:<traj>:"<evidence>" ...   # record (all 9 dims)
+runboard board [--html]       # heatmap + average + binding constraint
+runboard pulse                # compare the two latest assessments
+runboard roadmap              # Now/Next/Later from the binding constraint
+runboard report --type board-update|baseline|monthly
+runboard status               # one-screen current state
+```
+
+Dimension keys: `build.team`, `build.tools`, `build.techniques`, `run.team`, `run.tools`,
+`run.techniques`, `plan.team`, `plan.tools`, `plan.techniques`.
+
+## Typical flows
+
+- **Assess**: read anchors from `.runboard/rubric.yaml`, ask the leader per dimension,
+  then persist with a single `runboard assess --set ... ` call. See `skills/assess/`.
+- **Pulse / Roadmap / Board update**: run the matching command, read the generated file
+  under `.runboard/`, and read it back in business language. See the other `skills/`.
+
+## MCP
+
+For tool-calling clients, run `npx runboard-mcp` to expose the same capabilities as tools
+(`runboard_assess`, `runboard_board`, `runboard_pulse`, `runboard_roadmap`,
+`runboard_report`, `runboard_status`). These are thin wrappers over the same core, so
+their results match the CLI exactly.
+
+## Portable skills
+
+`skills/*/SKILL.md` are written to the open SKILL.md standard and run unmodified across
+agent platforms. They own the conversation; the CLI owns the computation.
+
+> Note: in published installs, `CLAUDE.md` is provided as a copy/symlink of this file so
+> Claude Code reads the same guidance. In this source repo, `CLAUDE.md` is the
+> contributor/Spec-Kit guide instead — this AGENTS.md is the end-user agent guide.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Runboard contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,59 @@
+# Runboard
+
+**See your technical-leadership maturity scorecard in five minutes — local-first, no signup, nothing leaves your machine.**
+
+Runboard is a CLI that runs the Runboard framework: a nine-dimension maturity instrument
+(Build / Run / Plan × Team / Tools / Techniques), scored 1–5 with trajectory indicators.
+It renders your scorecard as a heatmap, tells you your single biggest constraint, and
+tracks whether things are getting better over time.
+
+## Quickstart
+
+```bash
+npx runboard@latest init      # scaffold .runboard/ in your repo
+npx runboard@latest assess    # guided 9-dimension self-assessment
+npx runboard@latest board     # your heatmap + average + biggest constraint
+```
+
+Then, once you have data:
+
+```bash
+npx runboard@latest roadmap       # Now / Next / Later plan from your constraint
+npx runboard@latest board --html  # a shareable, self-contained board.html
+npx runboard@latest pulse         # (after a 2nd assessment) what moved since last time
+npx runboard@latest status        # one-screen current state
+```
+
+## Local-first, no phone-home
+
+Every command runs entirely on your machine. **No account, no network calls, no
+telemetry.** Your data lives in `.runboard/` in your own repo — commit it, and its git
+history becomes your trajectory record.
+
+## Commands
+
+| Command | What it does |
+|---------|--------------|
+| `runboard init` | Scaffold `.runboard/` (config, rubric, assessments). Idempotent. |
+| `runboard assess` | Record a 9-dimension assessment (interactive, or `--set` for agents). |
+| `runboard board [--html]` | Render the heatmap; `--html` writes a shareable file. |
+| `runboard pulse` | Compare the two latest assessments; flag stuck dimensions. |
+| `runboard roadmap` | Now/Next/Later plan from your binding constraint. |
+| `runboard report --type <t>` | Render a board-ready report from a template. |
+| `runboard status` | One-screen current state. |
+
+## Use it from your AI assistant
+
+Portable `skills/` (SKILL.md) and an MCP server (`npx runboard-mcp`) let Claude, Cursor,
+Codex, Copilot, Gemini, and other agents run the assessment conversation and persist
+results through the same core — the numbers are always computed by the tool, never by the
+model.
+
+## Contributing
+
+See [CONTRIBUTING.md](./CONTRIBUTING.md). This is a public project; work starts from
+GitHub issues.
+
+## License
+
+[MIT](./LICENSE)