create-agentic-starter 0.1.4 → 0.1.6

package/README.md

@@ -28,8 +28,8 @@ Run the command inside an existing project folder.
 The scaffold is non-interactive. It will:
 
 - recreate `.agentic/`
-- recreate `AGENTS.md`
-- preserve existing `README.md` and `.gitignore`, appending a marked `create-agentic-starter` section at the end
+- preserve existing `AGENTS.md` and `.gitignore`, appending a marked `create-agentic-starter` section when needed
+- never modify `README.md`
 - print the next step for the team
 
 ## Generated Structure

package/dist/index.js

@@ -1,9 +1,60 @@
 #!/usr/bin/env node
-import{mkdir as k,readFile as y,rm as j,writeFile as m}from"fs/promises";import i from"path";var v="AGENTS.md",x="README.md",A=".gitignore",p="<!-- from create-agentic-starter:agents:start -->",l="<!-- from create-agentic-starter:agents:end -->",u="<!-- from create-agentic-starter:start -->",g="<!-- from create-agentic-starter:end -->",w="# from create-agentic-starter:start",f="# from create-agentic-starter:end",b=[".agentic"],R=()=>({".agentic/init.md":`# Init
+import{mkdir as E,rm as q,writeFile as I}from"fs/promises";import l from"path";import{readFile as R,writeFile as u}from"fs/promises";import b from"path";function g(e){return e.replace(/[.*+?^${}()|[\]\\]/g,"\\$&")}function A(e,t,o,r){let n=new RegExp(`${g(o)}[\\s\\S]*?${g(r)}\\n?`,"m");if(n.test(e))return e.replace(n,`${t}
+`);let s=e.endsWith(`
+`)?`
+`:`
+
+`;return`${e}${s}${t}
+`}async function i(e,t,o,r,n){let s=b.join(e,t);try{let a=await R(s,"utf8"),j=A(a,o,r,n);await u(s,j,"utf8")}catch(a){if(a.code!=="ENOENT")throw a;await u(s,`${o}
+`,"utf8")}}var f="AGENTS.md",h=".gitignore",c="<!-- from create-agentic-starter:agents:start -->",m="<!-- from create-agentic-starter:agents:end -->",d="# from create-agentic-starter:start",p="# from create-agentic-starter:end",w=`${c}
+# Agentic Starter Guide
+
+This project includes a reusable AI working area under \`.agentic/\` for project kick-off and pre-delivery documentation.
+
+## What This Is For
+
+Use this scaffold when you want an AI tool to:
+
+- understand a project from files, notes, screenshots, and links
+- maintain structured project memory
+- generate markdown deliverables such as BRD, FRD, estimate, and proposal
+
+## Folder Purpose
+
+- \`.agentic/init.md\`: first prompt for every new AI session
+- \`.agentic/context.md\`: shared rules and folder map
+- \`.agentic/commands/\`: task-specific prompt files you reference in your AI tool
+- \`.agentic/workspace/project/\`: raw project inputs such as screenshots, notes, requirement docs, and reference links
+- \`.agentic/workspace/memory/\`: evolving AI-maintained project understanding
+- \`.agentic/workspace/documents/\`: polished markdown deliverables
+
+## How To Use It
+
+1. Open your AI tool in this project.
+2. Start every new session with \`@.agentic/init.md\`.
+3. Follow the command sequence below.
+
+## V1 Command Sequence
+
+1. \`@.agentic/init.md\`
+2. \`@.agentic/commands/project-requirements.md\`
+3. \`@.agentic/commands/architecture.md\`
+4. \`@.agentic/commands/create-brd.md\`
+5. \`@.agentic/commands/create-frd.md\`
+6. \`@.agentic/commands/create-estimate.md\`
+7. \`@.agentic/commands/create-proposal.md\`
+
+If your tool does not support \`@file\` references, paste the contents of the prompt file into a new chat manually.
+${m}
+`,k=`${d}
+.agentic/workspace/documents/
+.agentic/workspace/memory/
+${p}
+`;var y=[".agentic"],x=[".agentic",".agentic/commands",".agentic/workspace",".agentic/workspace/project",".agentic/workspace/memory",".agentic/workspace/documents"],v=()=>({".agentic/init.md":`# Init
 
 Read \`@.agentic/context.md\` first.
 
-You are starting a fresh AI session inside this project. Your job is to build lightweight orientation without over-reading the repository.
+You are starting a fresh AI session inside this project. Your job is to quickly understand what this project is, what context already exists, and what the user still needs to provide.
 
 ## Read Scope
 
@@ -15,18 +66,39 @@ You are starting a fresh AI session inside this project. Your job is to build li
    - inspect \`.agentic/workspace/documents/\`
 4. Use existing workspace context if it is already present.
 
+## Response Style
+
+1. Be concise and synthesis-first.
+2. Do not dump a full file inventory unless the user explicitly asks.
+3. Do not mirror the prompt structure back to the user.
+4. Respond with either:
+   - a short synthesized summary of what you understand, or
+   - a few focused questions if important context is still missing
+
 ## What To Do
 
-1. Summarize the root-level project structure.
-2. Summarize what already exists in \`.agentic/workspace/project/\`, \`.agentic/workspace/memory/\`, and \`.agentic/workspace/documents/\`.
-3. Build a lightweight understanding from:
-   - root-level structure
+1. Infer what kind of project this is from the root-level signals.
+2. Check whether \`.agentic/workspace/project/\`, \`.agentic/workspace/memory/\`, and \`.agentic/workspace/documents/\` already contain useful context.
+3. Build the best current understanding from:
+   - root-level signals
    - existing workspace files
    - the user's message in this chat
-4. If the user mentions screenshots, notes, requirement docs, links, or file paths, tell them how those should be placed or referenced under \`.agentic/workspace/project/\`.
-5. If project materials are missing, say what would be useful to add, but continue with what you can understand already.
-6. Ask only blocking clarification questions.
-7. End with:
+4. If project context is thin, ask a small number of targeted questions about:
+   - project goal
+   - target users
+   - scope or modules
+   - available references such as screenshots, docs, notes, links, or file paths
+   - desired outputs
+5. If enough context exists, give a short summary of the project and the most important missing pieces.
+6. If the user mentions screenshots, notes, requirement docs, links, or file paths, move or organize them into \`.agentic/workspace/project/\` by default unless the user explicitly says not to.
+7. After the first useful exchange, create or update:
+   - \`.agentic/workspace/memory/project-overview.md\`
+   - \`.agentic/workspace/memory/requirements.md\`
+   - \`.agentic/workspace/memory/open-questions.md\`
+8. Write drafts even from partial information.
+9. Clearly separate confirmed facts, assumptions, and open questions.
+10. Do not route immediately just because the workspace is empty. Do useful synthesis or ask focused questions first.
+11. Once you have done useful intake work, end with:
 
 \`Next type @.agentic/commands/project-requirements.md\`
 `,".agentic/context.md":`# Context
@@ -54,6 +126,8 @@ Use \`.agentic/workspace/project/\` for:
 - links captured into markdown files
 - user-supplied project references
 
+If relevant project materials are found outside this folder, move or organize them into \`.agentic/workspace/project/\` by default. Only leave them in place if the user explicitly says not to move them.
+
 ### Memory
 
 Use \`.agentic/workspace/memory/\` for:
@@ -77,8 +151,10 @@ Use \`.agentic/workspace/documents/\` for polished outputs:
 
 1. Reuse and improve existing workspace files when they already exist.
 2. Do not scan the whole repository unless the user explicitly asks.
-3. Ask only the minimum blocking questions required to continue.
-4. Always end by telling the user the exact next command to run.
+3. If relevant project assets are outside \`.agentic/workspace/project/\`, move them into the workspace by default and then use the workspace copy.
+4. Only avoid moving files when the user explicitly asks to keep them in place.
+5. Ask only the minimum blocking questions required to continue.
+6. Always end by telling the user the exact next command to run.
 `,".agentic/commands/project-requirements.md":`# Project Requirements
 
 Read:
@@ -91,17 +167,20 @@ Read:
 
 ## Your job
 
-1. Collect the project explanation, goals, users, scope, screenshots, references, and known deliverables.
-2. Accept either:
+1. Refine and deepen the initial understanding created during \`@.agentic/init.md\`.
+2. Collect any missing project explanation, goals, users, scope, screenshots, references, and known deliverables.
+3. Accept either:
    - existing file paths already shared by the user, or
    - fresh explanation typed in chat
-3. Tell the user where each input belongs under \`.agentic/workspace/project/\`.
-4. Create or update:
+4. Move or organize project inputs into \`.agentic/workspace/project/\` by default unless the user explicitly says not to.
+5. Organize and normalize the project context so the later architecture and document steps can rely on it.
+6. Create or update:
    - \`.agentic/workspace/memory/project-overview.md\`
    - \`.agentic/workspace/memory/requirements.md\`
    - \`.agentic/workspace/memory/open-questions.md\`
-5. Capture assumptions separately from confirmed facts.
-6. Ask only for missing details that block useful requirement understanding.
+7. Capture assumptions separately from confirmed facts.
+8. Reduce open questions where possible before handing off to architecture.
+9. Ask only for missing details that block useful requirement understanding.
 
 When done, tell the user:
 
@@ -123,7 +202,8 @@ Read:
 3. Cover frontend, backend, data, integrations, authentication, deployment, and key risks when relevant.
 4. Add a diagram description or mermaid diagram when supported.
 5. Mention draw.io MCP only as an optional tool if available in the user's environment.
-6. Ask only the minimum blocking questions.
+6. If relevant screenshots, notes, or references are found outside \`.agentic/workspace/project/\`, move or organize them into the workspace by default unless the user explicitly says not to.
+7. Ask only the minimum blocking questions.
 
 When done, tell the user:
 
@@ -143,7 +223,8 @@ Read:
 1. Create or update \`.agentic/workspace/documents/brd.md\`.
 2. Produce a polished markdown Business Requirements Document.
 3. Use confirmed facts first and clearly label assumptions where needed.
-4. If critical information is missing, ask only the minimum blocking questions before drafting.
+4. If relevant source material is outside \`.agentic/workspace/project/\`, move or organize it into the workspace by default unless the user explicitly says not to.
+5. If critical information is missing, ask only the minimum blocking questions before drafting.
 
 When done, tell the user:
 
@@ -164,7 +245,8 @@ Read:
 1. Create or update \`.agentic/workspace/documents/frd.md\`.
 2. Produce a polished markdown Functional Requirements Document.
 3. Cover modules, flows, validations, roles, and edge cases where relevant.
-4. Ask only the minimum blocking questions.
+4. If relevant source material is outside \`.agentic/workspace/project/\`, move or organize it into the workspace by default unless the user explicitly says not to.
+5. Ask only the minimum blocking questions.
 
 When done, tell the user:
 
@@ -185,7 +267,8 @@ Read:
 1. Create or update \`.agentic/workspace/documents/estimate.md\`.
 2. Produce a markdown estimate with effort breakdown, assumptions, dependencies, and risks.
 3. Keep the estimate aligned with the known scope and clearly state uncertainty.
-4. Ask only the minimum blocking questions.
+4. If relevant source material is outside \`.agentic/workspace/project/\`, move or organize it into the workspace by default unless the user explicitly says not to.
+5. Ask only the minimum blocking questions.
 
 When done, tell the user:
 
@@ -207,77 +290,8 @@ Read:
 1. Create or update \`.agentic/workspace/documents/proposal.md\`.
 2. Produce a polished markdown proposal using the known scope, architecture direction, and estimate.
 3. Make gaps explicit instead of inventing details.
-4. Ask only the minimum blocking questions.
+4. If relevant screenshots, decks, notes, or references are found outside \`.agentic/workspace/project/\`, move or organize them into the workspace by default unless the user explicitly says not to.
+5. Ask only the minimum blocking questions.
 
 When done, tell the user the v1 workflow is complete and list the generated files.
-`}),E=`${p}
-# Agentic Starter Guide
-
-This project includes a reusable AI working area under \`.agentic/\` for project kick-off and pre-delivery documentation.
-
-## What This Is For
-
-Use this scaffold when you want an AI tool to:
-
-- understand a project from files, notes, screenshots, and links
-- maintain structured project memory
-- generate markdown deliverables such as BRD, FRD, estimate, and proposal
-
-## Folder Purpose
-
-- \`.agentic/init.md\`: first prompt for every new AI session
-- \`.agentic/context.md\`: shared rules and folder map
-- \`.agentic/commands/\`: task-specific prompt files you reference in your AI tool
-- \`.agentic/workspace/project/\`: raw project inputs such as screenshots, notes, requirement docs, and reference links
-- \`.agentic/workspace/memory/\`: evolving AI-maintained project understanding
-- \`.agentic/workspace/documents/\`: polished markdown deliverables
-
-## How To Use It
-
-1. Open your AI tool in this project.
-2. Start every new session with \`@.agentic/init.md\`.
-3. Follow the command sequence below.
-
-## V1 Command Sequence
-
-1. \`@.agentic/init.md\`
-2. \`@.agentic/commands/project-requirements.md\`
-3. \`@.agentic/commands/architecture.md\`
-4. \`@.agentic/commands/create-brd.md\`
-5. \`@.agentic/commands/create-frd.md\`
-6. \`@.agentic/commands/create-estimate.md\`
-7. \`@.agentic/commands/create-proposal.md\`
-
-If your tool does not support \`@file\` references, paste the contents of the prompt file into a new chat manually.
-${l}
-`,q=`${u}
-## Agentic Starter
-
-This project includes a reusable AI workflow scaffold under \`.agentic/\`.
-
-Start every new AI session with:
-
-\`@.agentic/init.md\`
-
-Command flow:
-
-1. \`@.agentic/init.md\`
-2. \`@.agentic/commands/project-requirements.md\`
-3. \`@.agentic/commands/architecture.md\`
-4. \`@.agentic/commands/create-brd.md\`
-5. \`@.agentic/commands/create-frd.md\`
-6. \`@.agentic/commands/create-estimate.md\`
-7. \`@.agentic/commands/create-proposal.md\`
-${g}
-`,T=`${w}
-.agentic/workspace/documents/
-.agentic/workspace/memory/
-${f}
-`,I=[".agentic",".agentic/commands",".agentic/workspace",".agentic/workspace/project",".agentic/workspace/memory",".agentic/workspace/documents"];async function S(e){await Promise.all(b.map(t=>j(i.join(e,t),{recursive:!0,force:!0})))}async function N(e){await Promise.all(I.map(t=>k(i.join(e,t),{recursive:!0})))}async function P(e){let t=R();await Promise.all(Object.entries(t).map(([r,n])=>m(i.join(e,r),n,"utf8")))}function D(e,t,r,n){let a=new RegExp(`${d(r)}[\\s\\S]*?${d(n)}\\n?`,"m");if(a.test(e))return e.replace(a,`${t}
-`);let o=e.endsWith(`
-`)?`
-`:`
-
-`;return`${e}${o}${t}
-`}function d(e){return e.replace(/[.*+?^${}()|[\]\\]/g,"\\$&")}async function c(e,t,r,n,a){let o=i.join(e,t);try{let s=await y(o,"utf8"),h=D(s,r,n,a);await m(o,h,"utf8")}catch(s){if(s.code!=="ENOENT")throw s;await m(o,`${r}
-`,"utf8")}}async function M(){let e=process.cwd();await S(e),await N(e),await P(e),await c(e,v,E,p,l),await c(e,x,q,u,g),await c(e,A,T,w,f),console.log(""),console.log("create-agentic-starter: scaffold created successfully."),console.log(`Project folder: ${e}`),console.log(""),console.log("Next steps:"),console.log("1. Open your AI tool in this folder."),console.log("2. Start a new chat with @.agentic/init.md"),console.log("")}M().catch(e=>{let t=e instanceof Error?e.message:String(e);console.error(`create-agentic-starter: failed to scaffold project. ${t}`),process.exitCode=1});
+`});async function T(e){await Promise.all(y.map(t=>q(l.join(e,t),{recursive:!0,force:!0})))}async function S(e){await Promise.all(x.map(t=>E(l.join(e,t),{recursive:!0})))}async function N(e){let t=v();await Promise.all(Object.entries(t).map(([o,r])=>I(l.join(e,o),r,"utf8")))}async function P(){let e=process.cwd();await T(e),await S(e),await N(e),await i(e,f,w,c,m),await i(e,h,k,d,p),console.log(""),console.log("create-agentic-starter: scaffold created successfully."),console.log(`Project folder: ${e}`),console.log(""),console.log("Next steps:"),console.log("1. Open your AI tool in this folder."),console.log("2. Start a new chat with @.agentic/init.md"),console.log("")}P().catch(e=>{let t=e instanceof Error?e.message:String(e);console.error(`create-agentic-starter: failed to scaffold project. ${t}`),process.exitCode=1});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-agentic-starter",
-  "version": "0.1.4",
+  "version": "0.1.6",
   "description": "Scaffold a minimal AI-powered project delivery workflow inside the current folder.",
   "license": "MIT",
   "type": "module",