create-agentic-starter 0.1.5 → 0.1.6

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 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.
 
@@ -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\`
@@ -75,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:
@@ -98,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:
@@ -117,7 +172,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\`
@@ -147,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:
 
@@ -167,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:
 
@@ -188,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:
 
@@ -209,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:
 
@@ -231,58 +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.
-`}),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(`
-`)?`
-`:`
-
-`;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});
+`});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.5",
+  "version": "0.1.6",
   "description": "Scaffold a minimal AI-powered project delivery workflow inside the current folder.",
   "license": "MIT",
   "type": "module",