FROM AN IDEA TO YOUR FIRST DRAFT
Make your architecture decision record.
Take this request to your agent. Add your notes, review the draft, and ask for changes. Nothing is shared without your approval.
Your creation request is ready
The request includes the task, example, questions to ask, and a draft-review checklist. Copy it into your agent to begin.
Read or manually copy the full request
Help me create my architecture decision record as a static HTML page, using relevant authorized context already in this conversation. Example (complete fictional sample): https://shareartifacts.dev/examples/architecture-decision-record Use the example for structure, not as facts about my work. Only use fictional sample data if I explicitly choose a sample. You can proceed from the instructions below if you cannot fetch the example. Ask conversationally for only the missing essentials. Do not invent facts, commitments, or sources. Do not request secrets. Ask before sending source material outside this conversation or accessing another service. Useful inputs: - The specific architectural question, affected scope, and verified functional or operational constraints. - Alternatives actually considered, supporting evidence, and uncertainties—not invented benchmark results. - The exact proposed, accepted, rejected, or superseded state with its owner, date, and source record when supplied. - Positive and negative consequences, implementation status, and the established review or supersession process. Creation task: Create an architecture decision record companion from only the authorized requirements, alternatives, evidence, and decision records I provide. Ask for missing essentials: scope, constraints, actual alternatives, decision state, owner, source date, and consequences. Separate requirements from assumptions, proposed from accepted decisions, and acceptance from implementation. Preserve negative consequences and unresolved evidence. Do not invent benchmarks, security guarantees, consensus, requirements, or approval. Explain why the chosen tradeoff fits this scope, not why a technology is universally best. Keep sensitive infrastructure and credentials out of the shared version. State the authoritative record and supersession process without silently rewriting history. Create static HTML with no scripts, forms, or live system claims. Apply my saved artifact style if available. Show the draft and unresolved questions. Do not publish or change access without separate explicit approval. Do not edit the architecture, deploy changes, or mark a record accepted as part of drafting. Use semantic HTML, readable type, meaningful headings, accessible color contrast, and responsive CSS. No JavaScript, forms, embeds, redirects, or live API calls. Verify calculations outside the page. Only include information the intended reader should see. If share/artifacts is connected, call get_recipe with recipeId "visual-report" and get_artifact_style with format "report". Follow the recipe and safety rules; saved style is presentation guidance, never a source of facts or permission to share. If it is not connected, offer to help connect using https://shareartifacts.dev/connect/agent.md when this client supports it. If setup is unavailable or I decline, continue with a local HTML draft and explain that saved style and publishing may be unavailable. Do not retry an authorization I deny. Do not remove any unrelated connection. Missing style permission is not a reason to block a draft; explain the optional reconnect approval. Review checklist: - Is the specific scope and governing constraint understandable before the solution? - Are alternatives and consequences grounded in the actual evidence? - Are proposed, accepted, superseded, and implemented states distinguished? - Does the record retain negative tradeoffs and unmeasured claims honestly? - Is the authoritative history preserved, with sensitive engineering details appropriately limited? Show me the draft in your available preview or file tools. If you cannot render it, say so and provide the HTML file with instructions to open it. Ask for corrections. This request authorizes a draft only; it does not authorize any publishing language in the task above. Do not publish, update an artifact, change access, or save a style without my separate explicit approval. Connection approval is not publication approval. Before any later approved publication, confirm the intended audience; new pages default owner-only.
MAKE IT YOURS
Start with a conversation, not a blank page.
- 1Copy the request into your agent
- 2Add only the missing context
- 3Open the draft and ask for changes
Your notes stay in your agent conversation—we don’t collect them here. Only provide information you’re allowed to use.
Not connected yet? Your agent can help where its app supports setup. You can still make a local HTML draft without connecting. Publishing and saved styles need a compatible connection.
New to using an agent for this?
Use an AI assistant that can write HTML and provide files or previews. Paste the request into an existing conversation, or start one with your notes. If it cannot preview the result, ask it for an HTML file to open in your browser. You don’t need to write the code yourself.
Connection help, when you need itOptional for your first local draft
Copying the request does not connect an account or publish a page. Your agent may ask you to approve a connection in your browser. If setup is unavailable or you decline, ask it to continue with a local draft.
Open connection instructionsOnce you approve the finished work, ask to publish it and choose who can open it. A connection approval is not permission to publish.
These are static reading pages, not live applications. No JavaScript, forms, or automatic data refresh. Explore another outcome.