Example AI prompts¶✎ edit
Prompts to give your AI when it works on a d2 project, and the answers they got, grouped by the kind of user (Hero, Creator, Pro; see Help). Collected from the landing page, the home page templates and Help on 2026-09-27, plus real ones from building d2 itself. Where no answer was kept, the entry says what should come back.
Getting started¶✎ edit
List the topics in my d2 project.
Home and the rest of your project's topics. If it does, your AI is connected. (From Help, step 4.)
Make an app that shows …
An
App:topic holding a whole HTML page, opened at/app/<name>, with a card for it on your home page. (From Help, apps.)
In d2, make me a stylesheet called yahoo: the logo in the top bar says YAHOO, the background is dark green and the fonts are magenta.
A
Style:yahootopic you can pick on Styles; if a line is wrong, the page says which. (From Help, styles.)
Hero¶✎ edit
Your own app, with your data behind it.
Build me an app to track my portfolio: my holdings, what I paid, today's price, and tell me when a company I hold puts out news.
A working app with lists, pages and alerts, filled with your own data; change your mind and the app changes with it. The finished example is d2portfolio. (From the landing page, Hero.)
Import the portfolio example into my project and put in my three biggest holdings instead of the samples.
The portfolio's topics copied into your project, its card on your home page, your holdings in place of the samples. (From the Hero home page.)
I ride trails on my mountain bike. Keep track of the trails, when I rode them and the conditions, and show me which ones I haven't done in a while.
Not kept yet (the Bike trails example is coming). (From the Hero home page.)
Make me a garden planner: my beds, what's planted where, when I watered, and remind me what's due this week.
Not kept yet (the Garden example is coming). (From the Hero home page.)
Track my monthly budget: categories, what I planned and what I spent, and warn me when a category goes over.
Not kept yet (the Budget example is coming). (From the Hero home page.)
Creator¶✎ edit
Describe a domain. Use the app it becomes, right away.
Create a domain model for a mining company: its properties and claims, the deposits and their resource estimates, drill programs with holes and assays, and who owns what. Seed it with a few sample companies and let me see it.
The classes in a
Spec:topic, sample companies as objects, and the model graph at Domain, browsable in Data right away. The worked example is in the d2pro demo (Spec:mining-domain,Story:mining-samples). (From the landing page, Creator.)
Pro¶✎ edit
Prototype big domains, rules and APIs, fast. From building d2 itself, in d2spec.
add backlog to d2spec home as tile. users can redo their default home pages and drop system bits like backlog, system view etc. We need a Toolbox page that lists these, linked from the User menu - move Backlog from there into it. the new page has tiles for all system views (backlog, system view, domain, data, flows, fiddle etc) List there as tiles
[…]
Also done: the queued rename (10b4347, its own commit). The code, tests, seeds and READMEs now use the new topic names, so the components view reads Components again and the menu's Spec link goes to /topics/Spec. I checked the components page on the box; it shows its components again. The queue is empty and its note is deleted.
It's recorded in Spec §7.16, UiSpec §4, Routes, Testing (TB-1) and the ProjectLog, all under the new names
The backlog feature we just did, Spec §7.15, still mixes the two. It has the status markers, the Done-section rule and the draft mechanics. Want me to give it the same treatment?
yes, update the spec/uispec/design respectively. from now on we work per feature - i.e. a feature should belong either in the big spec and/or the uispec and has design/implementation and testing sections with a nice anchor so they line up in the system wide view. put that in the best practices […]
separately, users should have a handle like "bob" - on registration get this from the email "bob@…" and in preferences they should be able to change it. this handle is what we show in conflicts page etc - current users migrate them accordingly. update spec etc
also let admins see other's drafts and check that item
on checkpoints, publish drafts from all chats and anon
and collect this prompt and answer in the examples
Handles are live: every user got one from the first part of their email, changeable in Preferences, and they replace emails on the drafts page, in conflicts and on the members list. Admins now see other people's drafts with their diffs, and that to-do is ticked.
Working per feature is now BestPractices §1.7: each feature in Spec and/or UiSpec, with Design, Prototype1 and Testing sections sharing one anchor. Draft conflicts and handles are the first two done that way, lined up as
draftsandhandlesin the system-wide view.All of it is drafts, to publish at the next checkpoint, with every other chat's and the ops token's. (Razie, 2026-09-27.)
from now on, when we add new relevant functionality, it should be in the toolbox page. So we don't lose track of it.
From now on, any new feature a person can open gets a Toolbox tile in the same change that builds it.
- The rule is in the Design 15 draft.
- The project preferences have it too, so future chats follow it.
- The code chat has a notice in the queue. (Razie, 2026-09-27; dictated, the content chat answering.)
in the pipeline for my items, i.e. user, administrator, etc., I should have a small close button near the arrows, before the arrows. Put the space between that button and the arrows. So I can close my items from there. I don't have to dig inside it.
The close button is designed and written into the drafts:
- UiSpec, Pipeline: Close from the row. On your own items only (user, administrator, designer…), a small ✓ sits just before the ↑ ↓ arrows, with a clear gap between them. One tap closes the item; the row fades out and a toast offers Undo for a few seconds. On a phone the ✓ stays on the row while the arrows go into the row's menu. Items for agents or other people have no ✓.
- Spec: ^pipe-42, plus a line in 11. Decisions.
- Design: no new route; the ✓ uses the existing status change, and Undo sets the item back to its previous status.
- Testing: design test PIPE-43.
The Undo toast is my addition, because the ✓ sits right next to the arrows and is easy to hit by accident.
The coder is waiting on you. It has finished P-98 (v0.62.0 preview) and asks whether to take P-116 or P-86 next.
OK to send the close button to the coder? (Razie, 2026-09-28; dictated, the designer answering.)
I think he's already working on the close button.
You're right. The coder is working on P-117 (close from the row) together with P-116 (sync every element), so there's nothing to send.
The coder also left me a design call, P-114: work meant for agents should be filed for
<role> agent, not<role>, because otherwise it shows up red as yours. I'll file it that way from now on.The coder isn't waiting on anyone right now. For me, the next items are the design calls from the first review: P-105, P-107 and P-89. (Razie, 2026-09-28; dictated, the designer answering. Razie had already approved the close button in the coder's own chat; the item just didn't say so.)
add your last two answer and my prompts to the example chats.
I added both exchanges to ExampleAiPrompts, Pro, as a draft: the close-button request with its design answer, and your "already working on it" with my reply.
In the second entry I noted that the coder had picked up the close button from my board notice before you'd approved it. That goes against the rule that design reaches the coder only after your review. Say if you want the coder told to wait for an explicit hand-off. (Razie, 2026-09-28; dictated, the designer answering.)
No, it's okay. He asked me and I approved it there in his chat. He should have left a note that it was approved specifically by me.
Got it, that's fixed:
- ExampleAiPrompts, Pro: the note now says you had already approved the close button in the coder's chat, and the item just didn't record it.
- BestPractices, 3.4 Roles: new rule. When you approve something in a chat, that chat notes it on the pipeline item ("approved by Razie in the chat, ") and in its board notice.
- I sent the coder a board message asking it to add that note to P-117 now. (Razie, 2026-09-28; dictated, the designer answering. Shows the designer holding the review rule, and Razie's correction becoming a standing practice.)