generate-spec
Living spec
This markdown file is the spec for the work. It should stay true to the repo. It should show what is already there, and what is still planned. Use the same file for the whole job. Keep editing that file. Do not start a second walkthrough later.
Put the file at specs/<short-kebab-case-name>.md. Look up the current paths before you write. Do not keep asking questions. Write the page. Ask a question only when the answer would change how you split the work into phases.
When they change the plan, or when they ask you to implement, update this file so it still matches. Do that after the code lands too. If they only want a walkthrough of what a pull request did, and no spec exists yet, put that file under tmp/.
Serve and share
Run these commands from the repo root:
npx @tanishqkancharla/diffmap list
npx @tanishqkancharla/diffmap serve specs/<name>.md
npx @tanishqkancharla/diffmap specs/<name>.md does the same thing as serve. If list already shows that file, use the URL it already printed. Do not start a second server. Leave the server running. Tell them the file path and the URL. Do not open the browser unless they ask.