create-agentic-starter 0.1.3 → 0.1.4

package/README.md

@@ -1,11 +1,53 @@
 # create-agentic-starter
 
-Scaffolds a minimal AI-powered project delivery workflow into the current folder.
+`create-agentic-starter` scaffolds a lightweight `.agentic/` workspace inside an existing project so AI tools can follow a repeatable kick-off workflow.
+
+The goal is to avoid rebuilding the same project-start process every time. Instead of manually re-creating prompts and folders for every new client engagement, this package sets up a standard structure for:
+
+- requirement gathering
+- architecture thinking
+- BRD generation
+- FRD generation
+- estimation
+- proposal drafting
+
+It is designed for prompt-driven AI tools. The generated scaffold gives each new session a clear entrypoint with `@.agentic/init.md`, a set of reusable prompts in `.agentic/commands/`, and a workspace for project assets, memory, and generated documents.
 
 ## Usage
 
+```bash
+npx create-agentic-starter
+```
+
 ```bash
 bunx create-agentic-starter
 ```
 
-The command is non-interactive. It resets the generated scaffold paths, creates the `.agentic/` structure, and prints the next step for the team.
+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
+- print the next step for the team
+
+## Generated Structure
+
+The command sets up:
+
+- `.agentic/init.md`
+- `.agentic/context.md`
+- `.agentic/commands/`
+- `.agentic/workspace/project/`
+- `.agentic/workspace/memory/`
+- `.agentic/workspace/documents/`
+- `AGENTS.md`
+
+## First Run Flow
+
+After scaffolding:
+
+1. Open your AI tool in the project.
+2. Start a new session with `@.agentic/init.md`.
+3. Follow the command sequence defined in `AGENTS.md`.

package/dist/index.js

@@ -1,43 +1,5 @@
 #!/usr/bin/env node
-import{mkdir as f,readFile as h,rm as k,writeFile as c}from"fs/promises";import i from"path";var y="README.md",j=".gitignore",p="<!-- from create-agentic-starter:start -->",l="<!-- from create-agentic-starter:end -->",u="# from create-agentic-starter:start",g="# from create-agentic-starter:end",v=[".agentic","AGENTS.md"],x=()=>({"AGENTS.md":`# Agentic Starter Guide
-
-This scaffold creates 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.
-`,".agentic/init.md":`# Init
+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
 
 Read \`@.agentic/context.md\` first.
 
@@ -248,7 +210,47 @@ Read:
 4. Ask only the minimum blocking questions.
 
 When done, tell the user the v1 workflow is complete and list the generated files.
-`}),b=`${p}
+`}),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/\`.
@@ -266,16 +268,16 @@ Command flow:
 5. \`@.agentic/commands/create-frd.md\`
 6. \`@.agentic/commands/create-estimate.md\`
 7. \`@.agentic/commands/create-proposal.md\`
-${l}
-`,A=`${u}
+${g}
+`,T=`${w}
 .agentic/workspace/documents/
 .agentic/workspace/memory/
-${g}
-`,R=[".agentic",".agentic/commands",".agentic/workspace",".agentic/workspace/project",".agentic/workspace/memory",".agentic/workspace/documents"];async function q(e){await Promise.all(v.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=x();await Promise.all(Object.entries(t).map(([r,n])=>c(i.join(e,r),n,"utf8")))}function T(e,t,r,n){let a=new RegExp(`${m(r)}[\\s\\S]*?${m(n)}\\n?`,"m");if(a.test(e))return e.replace(a,`${t}
+${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 m(e){return e.replace(/[.*+?^${}()|[\]\\]/g,"\\$&")}async function d(e,t,r,n,a){let o=i.join(e,t);try{let s=await h(o,"utf8"),w=T(s,r,n,a);await c(o,w,"utf8")}catch(s){if(s.code!=="ENOENT")throw s;await c(o,`${r}
-`,"utf8")}}async function S(){let e=process.cwd();await q(e),await E(e),await I(e),await d(e,y,b,p,l),await d(e,j,A,u,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("")}S().catch(e=>{let t=e instanceof Error?e.message:String(e);console.error(`create-agentic-starter: failed to scaffold project. ${t}`),process.exitCode=1});
+`}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});

package/package.json

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