@arvorco/relentless 0.1.25 → 0.1.26

package/.claude/skills/constitution/SKILL.md

@@ -90,7 +90,11 @@ Read and analyze project documentation:
 
 ## Step 4: Generate Personalized Prompt
 
-Using the generic template from relentless, create a personalized `prompt.md` with:
+Load the base template from `templates/prompt.md` and personalize it:
+
+**Base Template Location:** `templates/prompt.md`
+
+Create a personalized `prompt.md` with:
 
 **Section 1: Quality Gates**
 ```markdown

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arvorco/relentless",
-  "version": "0.1.25",
+  "version": "0.1.26",
   "description": "Universal AI agent orchestrator - works with Claude Code, Amp, OpenCode, Codex, Droid, and Gemini",
   "type": "module",
   "publishConfig": {

package/src/init/scaffolder.ts

@@ -49,9 +49,17 @@ const relentlessRoot = getRelentlessRoot();
 
 /**
  * Files to create in the relentless/ directory
+ * These can be force-updated with -f flag
  */
 const RELENTLESS_FILES: Record<string, () => string> = {
   "config.json": () => JSON.stringify(DEFAULT_CONFIG, null, 2),
+};
+
+/**
+ * Files that should NEVER be overwritten, even with -f flag
+ * These are personalized files that users customize for their project
+ */
+const PROTECTED_FILES: Record<string, () => string> = {
   "prompt.md": () => PROMPT_TEMPLATE,
 };
 
@@ -171,7 +179,7 @@ export async function initProject(projectDir: string = process.cwd(), force: boo
     }
   }
 
-  // Create relentless files
+  // Create relentless files (can be force-updated)
   console.log(chalk.dim("\nCreating relentless files..."));
 
   for (const [filename, contentFn] of Object.entries(RELENTLESS_FILES)) {
@@ -187,6 +195,19 @@ export async function initProject(projectDir: string = process.cwd(), force: boo
     console.log(`  ${chalk.green("✓")} relentless/${filename} ${force ? `(${action})` : ""}`);
   }
 
+  // Create protected files (NEVER overwritten, even with -f)
+  for (const [filename, contentFn] of Object.entries(PROTECTED_FILES)) {
+    const path = join(relentlessDir, filename);
+
+    if (existsSync(path)) {
+      console.log(`  ${chalk.yellow("⚠")} relentless/${filename} already exists (protected, not overwriting)`);
+      continue;
+    }
+
+    await Bun.write(path, contentFn());
+    console.log(`  ${chalk.green("✓")} relentless/${filename} (created)`);
+  }
+
   // Note: constitution.md is NOT copied - it should be created by /relentless.constitution command
   // This ensures each project gets a personalized constitution
 

package/templates/prompt.md

@@ -0,0 +1,72 @@
+# Relentless Agent Instructions
+
+You are an autonomous coding agent. Follow these instructions exactly.
+
+**This is a generic template. Personalize it for your project using:**
+```bash
+/relentless.constitution
+```
+
+---
+
+## Your Task (Per Iteration)
+
+1. Read `relentless/features/<feature>/prd.json`
+2. Read `relentless/features/<feature>/progress.txt`
+3. Check you're on the correct branch from PRD `branchName`
+4. Pick the **highest priority** story where `passes: false`
+5. Review existing code to understand patterns
+6. Implement the story
+7. Run quality checks (typecheck, lint, test)
+8. If ALL checks pass, commit: `feat: [Story ID] - [Story Title]`
+9. Update PRD: set `passes: true`
+10. Append progress to `progress.txt`
+
+---
+
+## Quality Requirements
+
+Before marking a story complete:
+- [ ] All quality checks pass (typecheck, lint, test)
+- [ ] Zero errors and zero warnings
+- [ ] No debug code (console.log, debugger)
+- [ ] No unused imports or variables
+- [ ] Follows existing patterns
+
+---
+
+## Progress Report Format
+
+APPEND to progress.txt:
+```
+## [Date/Time] - [Story ID]
+- What was implemented
+- Files changed
+- Learnings for future iterations
+---
+```
+
+---
+
+## Stop Condition
+
+After completing a story, check if ALL stories have `passes: true`.
+
+If ALL complete:
+```
+<promise>COMPLETE</promise>
+```
+
+Otherwise, end normally (next iteration continues).
+
+---
+
+## Notes
+
+This is the default template. You should personalize `relentless/prompt.md` with:
+- Your project's specific quality commands
+- Your testing framework and patterns
+- Your coding conventions
+- Project-specific gotchas
+
+Run `/relentless.constitution` to generate a personalized prompt.