From ee8f8699059819ae06ea58b2a8eeb8a65a633a54 Mon Sep 17 00:00:00 2001 From: Matt Mabrey Date: Thu, 20 Aug 2026 14:17:27 -0700 Subject: [PATCH] Initial import: SDE meeting toolkit (workshop tools + breadcrumb skill) --- .gitignore | 4 + README.md | 116 ++++ package.json | 10 + skills/construction-breadcrumbs.skill | Bin 0 -> 7130 bytes tools/field-problem-workshop.html | 841 ++++++++++++++++++++++++++ tools/scope-lock-meeting-suite.html | 742 +++++++++++++++++++++++ 6 files changed, 1713 insertions(+) create mode 100644 .gitignore create mode 100644 README.md create mode 100644 package.json create mode 100644 skills/construction-breadcrumbs.skill create mode 100644 tools/field-problem-workshop.html create mode 100644 tools/scope-lock-meeting-suite.html diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..effa2fc --- /dev/null +++ b/.gitignore @@ -0,0 +1,4 @@ +node_modules/ +.DS_Store +Thumbs.db +*.log diff --git a/README.md b/README.md new file mode 100644 index 0000000..b5273cb --- /dev/null +++ b/README.md @@ -0,0 +1,116 @@ +# Project SDE Meeting Toolkit + +## Purpose + +This folder holds two workshop tools for Project SDE. Each tool is one HTML file. Each tool runs in a web browser. The tools do not need a server or a database. The tools do not connect to the Work Package Suite application. + +## Contents + +| File | Purpose | +|---|---| +| `tools/field-problem-workshop.html` | Field problem workshop. Captures problems, groups them into clusters, and records breadcrumbs and actions. | +| `tools/scope-lock-meeting-suite.html` | Scope lock meeting suite. Holds the scope boundary board, the MVP priority ranker, the decision registry, and the Micron pilot readiness check. | +| `skills/construction-breadcrumbs.skill` | A Claude skill. The skill encodes the breadcrumb method. Install this skill to use the method in any Claude chat. | + +## Requirements + +Install Node.js version 18 or later to run the local server. Node.js includes `npx`. + +You do not need Node.js to open a tool file directly in a browser. + +## Setup + +Follow these steps to set up the project on your computer. + +1. Open a terminal. +2. Go to the `sde-meeting-toolkit` folder. +3. Run this command to check that Git tracks the folder: + ``` + git status + ``` + +The setup step ends here. The project has no other dependencies to install. + +## Run a tool + +Choose one of the two methods below. + +### Method 1: Open the file directly + +1. Open a file browser. +2. Go to the `tools` folder. +3. Double-click a tool file to open it in your default browser. + +This method works offline. This method does not run the AI draft button in the Field Problem Workshop. + +### Method 2: Run a local server + +Use this method to test the tools the way a browser would load them from a web server. + +1. Open a terminal. +2. Go to the `sde-meeting-toolkit` folder. +3. Run this command: + ``` + npm run serve + ``` +4. Open a browser. +5. Go to this address: `http://localhost:5173` +6. Click a tool file under the `tools` folder. +7. Press `Ctrl+C` in the terminal to stop the server. + +### Method 3: Use the tool as a Claude artifact + +Use this method to run the AI draft button in the Field Problem Workshop. + +1. Open a chat in Claude. +2. Upload the tool file, or add it to a Claude project. +3. Ask Claude to render the file as an artifact. + +The AI draft button needs a network connection and the Claude environment. Outside of Claude, the button fails without an error. + +## Save and load your work + +The two tools store data in different ways. + +**Field Problem Workshop**: The tool holds data in the browser session only. Closing the browser tab erases unsaved data. + +1. Click Export JSON before you close the tool. +2. Save the JSON file to your computer. +3. Click Load JSON the next time you open the tool. +4. Select the saved JSON file to restore your data. + +**Scope Lock Meeting Suite**: The tool saves data automatically to the browser's local storage on the computer where you open it. Local storage does not transfer to another computer. + +1. Click Export in the tool to create a durable record. +2. Save the exported file to your computer or to a shared drive. + +## Reset a tool + +Each tool has a Reset control. + +- Field Problem Workshop: Reset returns the tool to the July 21 baseline. The baseline holds 43 problems in 7 root clusters, 6 breadcrumbs, and 5 actions. +- Scope Lock Meeting Suite: Reset returns the tool to its starting state. + +Reset erases current data in the tool. Export your data before you click Reset. + +## Install the skill + +1. Open Claude. +2. Open the skill file: `skills/construction-breadcrumbs.skill`. +3. Use the Save skill action to install it. +4. Open a new chat to use the skill. + +## Version control + +This folder is a Git repository. Use normal Git commands to track changes. + +``` +git add . +git commit -m "Describe your change here" +``` + +The `.gitignore` file excludes `node_modules` and common system files from commits. + +## Relation to the Work Package Suite + +These tools support meetings about the Work Package Suite project. The tools do not call the Work Package Suite application. The tools do not read or write Work Package Suite data. Treat this toolkit and the Work Package Suite codebase as separate projects. diff --git a/package.json b/package.json new file mode 100644 index 0000000..23c235c --- /dev/null +++ b/package.json @@ -0,0 +1,10 @@ +{ + "name": "sde-meeting-toolkit", + "version": "1.0.0", + "private": true, + "description": "Local environment for the Project SDE meeting and workshop tools", + "scripts": { + "serve": "npx --yes serve . -l 5173", + "start": "npm run serve" + } +} diff --git a/skills/construction-breadcrumbs.skill b/skills/construction-breadcrumbs.skill new file mode 100644 index 0000000000000000000000000000000000000000..ece6843ac465e1f9f7603ced804e33a7ad67ee5b GIT binary patch literal 7130 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 E7l#zDHUIzs literal 0 HcmV?d00001 diff --git a/tools/field-problem-workshop.html b/tools/field-problem-workshop.html new file mode 100644 index 0000000..0809142 --- /dev/null +++ b/tools/field-problem-workshop.html @@ -0,0 +1,841 @@ + + + + + +Project SDE | Field Problem Workshop v5 + + + + +
+
Project SDE | Field Problem Workshop v5
+
+ State lives in this session. Save JSON before closing. + + + + + +
+ + + +
+ + +
+
+

Problem Map

+

Capture at the top; new items land in the red tray until attached to a root problem. Each cluster is a root problem and the issues under it are the evidence. Vote with dots directly on the cluster headers, then promote the winners to Breadcrumbs.

+
+
+ + + + +
+
+
+
+ + +
+
+ + +
+
+

Breadcrumbs

+

Root problem to value driver to capability to measurable outcome. A completed breadcrumb IS a pilot success criterion; the export builds the criteria table from every complete card. AI draft fills the fields from construction execution methodology (EVM, CII AWP, Last Planner, first-time quality); the room reviews and edits.

+
+
+
+
+
+ + +
+
+

Actions

+

Every open item gets an owner and a date. Scan adds an action for each incomplete breadcrumb, each cluster missing a root statement, and any unclustered issues.

+
+
+ +
+
+
+ + +
+
+ +
+ +
+ + + + diff --git a/tools/scope-lock-meeting-suite.html b/tools/scope-lock-meeting-suite.html new file mode 100644 index 0000000..7de1b29 --- /dev/null +++ b/tools/scope-lock-meeting-suite.html @@ -0,0 +1,742 @@ + + + + + +Project SDE | Scope Lock Meeting Suite + + + + +
+
Project SDE | Scope Lock Meeting Suite
+
+
Micron Pilot | Innovation Team
+ + +
+ + + +
+ + +
+
+

Scope Boundary Board

+

Every item gets a home before the meeting ends. In MVP means the 3 month construction tracking build. Later Phase means committed but sequenced after MVP. Out means not part of Project SDE. Parking Lot means undecided, and each parked item needs an owner and a date in the Decision Registry.

+
+ +
+

Unsorted

+
Work top to bottom. Assign each item with the buttons on its card.
+
+
+ + +
+
+ +
+
+

In MVP

0
+
Ships in the 3 month build
+
+
+
+

Later Phase

0
+
Committed, sequenced after MVP
+
+
+
+

Out

0
+
Not part of Project SDE
+
+
+
+

Parking Lot

0
+
Needs owner + date in Registry
+
+
+
+
+ + +
+
+

MVP Priority Ranker

+

Forced ranking. If the 3 month timeline slips, items below the cut line are the first to be descoped. Move items with the arrows until the room agrees on the order.

+
+
+
+
+ + +
+
+
+ + +
+
+

Decision Registry

+

Log every scope decision as it is made, with the trade off the team accepted. Nothing stays verbal only. Locked means it does not get relitigated without a formal change.

+
+ +
+
+ + +
+
+ + +
+
+ + +
+
+ + +
+
+ + +
+
+ + +
+
+ +
+
+ +
+
+ + +
+
+

Micron Pilot Readiness

+

What must be true at Micron before the pilot can start. Tap the status to cycle it. Anything Blocked at the end of the meeting needs a decision in the Registry.

+
+
+
+
0Ready
+
0In progress
+
0Blocked
+
0Not started
+
+
+
+ + +
+
+
+ +
+ +
+ + + +