Prototypes and the Spec Ledger
Attach the working examples and code behind a spec as prototypes, share newer versions with a dated history, keep three notes on each spec (Delivered, Needed, Blocked By), and see them all in the Specifications table with saved views. Clients can add prototypes to their own company's specs in the portal.
On this page
What prototypes and the ledger are for#
A spec often starts life as something you can click: a working example someone built, and the code behind it. Prototypes keep those links on the spec itself, with a record of every newer version and who shared it. The ledger is three short notes on each spec that say where it stands: what has been delivered, what is still needed, and what it is waiting on.
Both are notes about the spec, not part of it. Adding a prototype or writing a ledger note never changes what the spec says, adds nothing to its history, and never needs approval, even in a category where changes do.
They are available on specs only: articles in a category that holds specs, or under one.
Prototypes#
Seeing a spec's prototypes#
Open the spec in the article editor. The Prototypes section in the right-hand column lists its prototypes, most recently shared first, and its heading counts them (1 prototype, or None). Each prototype shows:
- its label, or Prototype when it has none;
- an Example link, a Code link, or both. They open in a new tab; DevStride never opens, loads or runs them itself;
- who added it, how often it has been shared, and when last: Jeff Lee · shared 3 times · last Nov 18, 2026.
When a prototype has been shared more than once, Show history lists every share, newest first, with its date, who shared it and the links used that time. A share from a client shows the client's name.
Until the spec has one, the section says No prototypes yet.
Adding a prototype#
- In the Prototypes section, click Add prototype.
- Optionally type a Label, such as Ledger view, from Jeff.
- Paste an Example link, a Code link, or both. At least one is needed.
- Click Add.
You are recorded as the person who shared it. Each link must be a full http:// or https:// address with no spaces; anything else is refused with Use a full http:// or https:// link, with no spaces.
A spec can carry up to 20 prototypes. Prototypes cannot be removed, and a label cannot be changed once added.
Sharing a newer version#
When a better version arrives, record it on the same prototype rather than adding another:
- Click Reshare on the prototype.
- The links start as they were last shared. Change them to the new ones.
- Click Reshare.
The new links become the prototype's current links, its share count goes up by one, and a dated entry joins its history. Earlier entries are never changed. A prototype keeps up to 500 shares; after that, add a new prototype.
Finding specs that came from a prototype#
On the Specifications tab of Manage articles, switch on From a prototype to list only specs that carry at least one prototype. It works together with the state buttons, the stage filter, Needs attention, the category and the search box.
The spec ledger#
Open the spec in the article editor. The Ledger section in the right-hand column holds three notes, and its heading says how many are filled in (2 of 3 filled in, or Empty):
| Note | For |
|---|---|
| Delivered | What has been done with it |
| Needed | What building it needs |
| Blocked By | Who or what it waits on |
Type in a note and click away: it saves when you leave the field. Press Esc to put back the saved note. Each note holds up to 2,000 characters, and clearing a note empties it.
Ledger notes are for your team only. Your clients never see them, on the portal or anywhere else.
The Specifications table#
On Manage articles, the Specifications tab lists specs in a table you can shape, like the Manage Items table. Every column is shown at first; Title and Stage always stay.
| Column | Shows |
|---|---|
| Title, Stage, Category, State | The spec, its stage badge, where it is filed, and draft, published or archived |
| Progress, Points, Dates, Needs attention | How far its linked work has got. See Seeing how far a spec's work has got |
| Example, Code | The most recently shared prototype's current links (Open and Code), opening in a new tab |
| Shared by | Who added that prototype |
| First shared | When the spec's first prototype was added |
| Last shared | When any of its prototypes was last shared, and how many it carries: 2 days ago · 3 prototypes |
| Delivered, Needed, Blocked By | The ledger notes. Hover a cell to read the whole note |
A dash means there is nothing to show. While you search with the search box, the work, prototype and ledger columns show a dash; clear the search to see them again.
Click a row to open the spec. Dragging a row onto the category tree files it there, as on the other tabs.
Choosing columns and saving views#
- Table columns in the toolbar opens the column manager: show, hide and reorder columns as on Manage Items.
- Views saves the current table as a view, and applies or manages saved views. A view keeps the columns you chose and these filters: the category, the stage, Needs attention, From a prototype and the search text. See Creating & Sharing Views.
What your clients see#
A client signed in to the portal sees a Prototypes section on their own company's specs:
- on a client spec draft once it has been saved, and
- on that spec after your team publishes it, as long as it stays marked for the portal and shared only with their company.
Prototypes never show on specs your team wrote, on another company's specs, on archived specs, or on internal ones. There they see each prototype's label, its Example and Code links, Added by whoever added it, how often it was shared, and, when it was shared more than once, a History of dates and names. Anyone on your team appears as Support, never by name. See Sharing prototypes for what clients can do there.
Prototypes your clients add appear in your editor's Prototypes section under the client's name, and you can reshare them like any other.
Who can do what#
| To | You need |
|---|---|
| See a spec's Prototypes and Ledger sections | Any Knowledge Base permission, plus access to the spec |
| Add or reshare a prototype | The same access as editing the spec's content: Create knowledge-base articles and edit access to it (your own, a Can edit share, or Edit any member's), plus Edit knowledge-base articles you authored or Publish once it is published. Not on an archived spec. A proposed change waiting on the spec does not block it |
| Write the ledger notes | Create knowledge-base articles plus edit access to the spec (your own, a Can edit share, or Edit any member's). Editing a published spec's words is not needed, and it works on archived specs too |
| Use the Specifications table, its columns, views and From a prototype | Anyone who can open Manage articles |
There is no separate permission for prototypes or the ledger. See Knowledge Base permissions.
Using the DevStride MCP Server#
AI assistants connected through the DevStride MCP Server can do the same work, with your permissions: list_kb_article_prototypes, add_kb_article_prototype and reshare_kb_article_prototype for prototypes, and update_kb_article_ledger for the three notes. find_kb_articles with hasPrototype: "true" lists the specs that carry a prototype.
Related#
- Specs and work items: link specs to the work built from them and see how far it has got.
- Client spec drafts: specs your clients write in the portal.
- Spec stages: label where a spec has got to.
- Knowledge Base permissions: who can edit specs.