create-agentic-starter 0.1.4 → 0.1.5

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,9 @@
 #!/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 f,readFile as w,rm as k,writeFile as c}from"fs/promises";import i from"path";var y="AGENTS.md",j=".gitignore",p="<!-- from create-agentic-starter:agents:start -->",u="<!-- from create-agentic-starter:agents:end -->",l="# from create-agentic-starter:start",g="# from create-agentic-starter:end",x=[".agentic"],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 +15,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, tell them how those should be placed or referenced under \`.agentic/workspace/project/\`.
+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
@@ -91,17 +112,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. Tell the user where each input belongs under \`.agentic/workspace/project/\`.
+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:
 
@@ -210,7 +234,7 @@ Read:
 4. Ask only the minimum blocking questions.
 
 When done, tell the user the v1 workflow is complete and list the generated files.
-`}),E=`${p}
+`}),b=`${p}
 # Agentic Starter Guide
 
 This project includes a reusable AI working area under \`.agentic/\` for project kick-off and pre-delivery documentation.
@@ -249,35 +273,16 @@ Use this scaffold when you want an AI tool to:
 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}
+${u}
+`,q=`${l}
 .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(`
+${g}
+`,R=[".agentic",".agentic/commands",".agentic/workspace",".agentic/workspace/project",".agentic/workspace/memory",".agentic/workspace/documents"];async function A(e){await Promise.all(x.map(t=>k(i.join(e,t),{recursive:!0,force:!0})))}async function E(e){await Promise.all(R.map(t=>f(i.join(e,t),{recursive:!0})))}async function I(e){let t=v();await Promise.all(Object.entries(t).map(([o,n])=>c(i.join(e,o),n,"utf8")))}function T(e,t,o,n){let s=new RegExp(`${m(o)}[\\s\\S]*?${m(n)}\\n?`,"m");if(s.test(e))return e.replace(s,`${t}
+`);let r=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});
+`;return`${e}${r}${t}
+`}function m(e){return e.replace(/[.*+?^${}()|[\]\\]/g,"\\$&")}async function d(e,t,o,n,s){let r=i.join(e,t);try{let a=await w(r,"utf8"),h=T(a,o,n,s);await c(r,h,"utf8")}catch(a){if(a.code!=="ENOENT")throw a;await c(r,`${o}
+`,"utf8")}}async function N(){let e=process.cwd();await A(e),await E(e),await I(e),await d(e,y,b,p,u),await d(e,j,q,l,g),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("")}N().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.5",
   "description": "Scaffold a minimal AI-powered project delivery workflow inside the current folder.",
   "license": "MIT",
   "type": "module",