create-agentic-starter 0.1.5 → 0.1.7

package/dist/index.js

@@ -1,5 +1,56 @@
 #!/usr/bin/env node
-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
+import{mkdir as I,rm as A,writeFile as E}from"fs/promises";import u from"path";import{readFile as R,writeFile as l}from"fs/promises";import b from"path";function g(e){return e.replace(/[.*+?^${}()|[\]\\]/g,"\\$&")}function q(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 a(e,t,o,r,n){let s=b.join(e,t);try{let i=await R(s,"utf8"),j=q(i,o,r,n);await l(s,j,"utf8")}catch(i){if(i.code!=="ENOENT")throw i;await l(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.
 
@@ -39,7 +90,7 @@ You are starting a fresh AI session inside this project. Your job is to quickly
    - 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/\`.
+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\`
@@ -47,7 +98,8 @@ You are starting a fresh AI session inside this project. Your job is to quickly
 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:
+11. If important project basics are still missing, continue asking focused questions and keep updating the memory files instead of routing forward yet.
+12. Only when you have done enough useful intake work to create a solid initial understanding, end with:
 
 \`Next type @.agentic/commands/project-requirements.md\`
 `,".agentic/context.md":`# Context
@@ -75,6 +127,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:
@@ -98,8 +152,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:
@@ -117,7 +173,7 @@ Read:
 3. Accept either:
    - existing file paths already shared by the user, or
    - fresh explanation typed in chat
-4. Tell the user where each input belongs under \`.agentic/workspace/project/\`.
+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\`
@@ -125,9 +181,10 @@ Read:
    - \`.agentic/workspace/memory/open-questions.md\`
 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.
+9. If the requirement understanding is still weak or important gaps remain, continue asking focused project questions and keep updating the memory files.
+10. Only ask for missing details that block useful requirement understanding.
 
-When done, tell the user:
+When the requirements are strong enough for architecture work, tell the user:
 
 \`Next type @.agentic/commands/architecture.md\`
 `,".agentic/commands/architecture.md":`# Architecture
@@ -147,9 +204,11 @@ 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. If architecture-critical information is still missing, ask architecture-specific questions and keep updating \`.agentic/workspace/memory/architecture.md\` instead of routing yet.
+8. Ask only the minimum blocking questions.
 
-When done, tell the user:
+When the architecture is strong enough for BRD drafting, tell the user:
 
 \`Next type @.agentic/commands/create-brd.md\`
 `,".agentic/commands/create-brd.md":`# Create BRD
@@ -167,9 +226,10 @@ 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 and keep improving the BRD draft instead of routing yet.
 
-When done, tell the user:
+When the BRD is solid enough to define functional requirements, tell the user:
 
 \`Next type @.agentic/commands/create-frd.md\`
 `,".agentic/commands/create-frd.md":`# Create FRD
@@ -188,9 +248,11 @@ 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. If important functional details are still missing, ask focused follow-up questions and keep improving the FRD instead of routing yet.
+6. Ask only the minimum blocking questions.
 
-When done, tell the user:
+When the FRD is strong enough for estimation, tell the user:
 
 \`Next type @.agentic/commands/create-estimate.md\`
 `,".agentic/commands/create-estimate.md":`# Create Estimate
@@ -209,9 +271,11 @@ 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. If the estimate is too uncertain because key delivery information is missing, ask focused follow-up questions and keep refining the estimate instead of routing yet.
+6. Ask only the minimum blocking questions.
 
-When done, tell the user:
+When the estimate is strong enough for proposal drafting, tell the user:
 
 \`Next type @.agentic/commands/create-proposal.md\`
 `,".agentic/commands/create-proposal.md":`# Create Proposal
@@ -231,58 +295,9 @@ 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.
-
-When done, tell the user the v1 workflow is complete and list the generated files.
-`}),b=`${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.
-${u}
-`,q=`${l}
-.agentic/workspace/documents/
-.agentic/workspace/memory/
-${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(`
-`)?`
-`:`
+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. If key proposal inputs are still missing, ask focused questions and keep improving the proposal instead of prematurely declaring completion.
+6. Ask only the minimum blocking questions.
 
-`;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});
+When the proposal is complete enough for handoff, tell the user the v1 workflow is complete and list the generated files.
+`});async function T(e){await Promise.all(y.map(t=>A(u.join(e,t),{recursive:!0,force:!0})))}async function S(e){await Promise.all(x.map(t=>I(u.join(e,t),{recursive:!0})))}async function N(e){let t=v();await Promise.all(Object.entries(t).map(([o,r])=>E(u.join(e,o),r,"utf8")))}async function D(){let e=process.cwd();await T(e),await S(e),await N(e),await a(e,f,w,c,m),await a(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("")}D().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.5",
+  "version": "0.1.7",
   "description": "Scaffold a minimal AI-powered project delivery workflow inside the current folder.",
   "license": "MIT",
   "type": "module",