@arvorco/relentless 0.1.18 → 0.1.20

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

@@ -12,9 +12,10 @@ Create a personalized project constitution that defines your team's coding princ
 ## The Job
 
 1. Ask the user about their project's coding philosophy and standards
-2. Generate a personalized constitution based on their answers
-3. Save to `relentless/constitution.md`
-4. Ensure consistency with project templates and documentation
+2. Analyze the project structure and documentation
+3. Generate personalized constitution based on their answers → `relentless/constitution.md`
+4. Generate personalized agent prompt based on the same analysis → `relentless/prompt.md`
+5. Ensure consistency with project templates and documentation
 
 **Important:** The constitution is the foundation for all feature work - create this before generating features.
 
@@ -67,31 +68,126 @@ Load the template from `templates/constitution-template.md` and:
 
 ---
 
-## Step 3: Validate & Save
+## Step 3: Analyze Project Structure
+
+Read and analyze project documentation:
+
+**Core Files:**
+- `README.md` - Project overview, setup instructions
+- `AGENTS.md` or `CLAUDE.md` - Developer guidelines
+- `package.json` - Scripts, dependencies, tech stack
+- `CONTRIBUTING.md` - Contribution workflow (if exists)
+
+**Extract:**
+- Tech stack (TypeScript, React, Node, etc.)
+- Testing framework (vitest, jest, playwright)
+- Quality commands (`typecheck`, `lint`, `test`)
+- Build system (bun, npm, turbo, vite)
+- Linting setup (eslint, biome)
+- File structure patterns
+
+---
+
+## Step 4: Generate Personalized Prompt
+
+Using the generic template from relentless, create a personalized `prompt.md` with:
+
+**Section 1: Quality Gates**
+```markdown
+## CRITICAL: Quality Gates (Non-Negotiable)
+
+Before marking ANY story as complete:
+
+\`\`\`bash
+# TypeScript (detected from package.json)
+[actual typecheck command from package.json scripts]
+
+# Linting (detected from package.json)
+[actual lint command from package.json scripts]
+
+# Tests (detected from package.json)
+[actual test command from package.json scripts]
+\`\`\`
+
+**If ANY check fails, DO NOT mark the story as complete.**
+```
+
+**Section 2: Project-Specific Patterns** (from README/AGENTS.md)
+- Monorepo structure (if applicable)
+- Component locations
+- Test file patterns
+- Database/backend info
+- Styling approach
+
+**Section 3: TDD Workflow** (if tests exist)
+- Test-first workflow
+- Test location patterns
+- Test commands
+
+**Section 4: Common Pitfalls** (from AGENTS.md/docs)
+- Project-specific gotchas
+- Known issues
+- Best practices
+
+**Footer:**
+```markdown
+---
+**Personalized for [Project Name]**
+**Generated:** [date]
+**Re-generate:** /relentless.constitution
+```
+
+Save to: `relentless/prompt.md`
+
+---
+
+## Step 5: Validate & Save
 
 Before saving:
-- No `[PLACEHOLDER]` tokens remain (unless explicitly marked as TODO)
+
+**Constitution:**
+- No `[PLACEHOLDER]` tokens remain
 - All dates in ISO format (YYYY-MM-DD)
 - Principles are declarative and testable
 - Version format is semantic (X.Y.Z)
 
-Save to: `relentless/constitution.md`
+**Prompt:**
+- All quality commands are actual commands from package.json
+- File patterns match project structure
+- No generic placeholders remain
+
+Save both files:
+- `relentless/constitution.md`
+- `relentless/prompt.md`
 
 ---
 
-## Step 4: Report
+## Step 6: Report
 
 Output summary:
-- Constitution version created
-- Number of principles defined
-- Key MUST/SHOULD rules
-- Next steps: "Now create your first feature with `/relentless.specify`"
+```
+✓ Created constitution.md
+  - Version: 1.0.0
+  - Principles: [count]
+  - Key rules: [summary]
+
+✓ Created prompt.md
+  - Quality gates: [count]
+  - Tech stack: [detected stack]
+  - Test framework: [detected]
+
+Next steps:
+1. Review both files
+2. Create your first feature: /relentless.specify "feature description"
+```
 
 ---
 
-## Updating Existing Constitution
+## Updating Existing Files
+
+If `relentless/constitution.md` or `relentless/prompt.md` exist:
 
-If `relentless/constitution.md` exists:
+**For Constitution Updates:**
 1. Load current version
 2. Ask what needs to change
 3. Increment version appropriately:
@@ -101,6 +197,15 @@ If `relentless/constitution.md` exists:
 4. Update `LAST_AMENDED_DATE` to today
 5. Add amendment notes at top
 
+**For Prompt Updates:**
+1. Re-analyze project structure (package.json, docs)
+2. Detect any new quality commands or patterns
+3. Regenerate personalized sections
+4. Preserve any manual customizations in comments
+5. Update "Generated" date
+
+**Both files can be regenerated at any time by running `/relentless.constitution` again.**
+
 ---
 
 ## Example Constitution Structure

package/README.md

@@ -30,8 +30,11 @@ bun install -g github:ArvorCo/Relentless
 cd your-project
 relentless init
 
-# 3. Create constitution (personalized governance)
+# 3. Create constitution and prompt (personalized governance + agent instructions)
 /relentless.constitution
+# This creates BOTH:
+# - relentless/constitution.md (project principles)
+# - relentless/prompt.md (personalized agent instructions)
 
 # 4. Create feature specification
 /relentless.specify Add user authentication with OAuth2

package/package.json

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

package/src/init/scaffolder.ts

@@ -57,64 +57,64 @@ const RELENTLESS_FILES: Record<string, () => string> = {
 
 const PROMPT_TEMPLATE = `# Relentless Agent Instructions
 
-You are an autonomous coding agent working on a software project.
+You are an autonomous coding agent. Follow these instructions exactly.
 
-## Before You Start
+**⚠️ This is a generic template. Personalize it for your project using:**
+\`\`\`bash
+/relentless.prompt
+\`\`\`
+
+---
+
+## Your Task (Per Iteration)
 
-1. **Review the codebase** - Understand the current state, architecture, and patterns
-2. **Read progress.txt** - Check the Codebase Patterns section for learnings from previous iterations
-3. **Read the PRD** - Understand what needs to be done
+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
 
-## Your Task
+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
 
-1. Read the PRD at \`relentless/features/<feature>/prd.json\`
-2. Read the progress log at \`relentless/features/<feature>/progress.txt\`
-3. Check you're on the correct branch from PRD \`branchName\`. If not, check it out or create from main.
-4. Pick the **highest priority** user story where \`passes: false\`
-5. **Review relevant code** before implementing - understand existing patterns
-6. Implement that single user story
-7. Run quality checks (typecheck, lint, test - whatever your project requires)
-8. If checks pass, commit ALL changes with message: \`feat: [Story ID] - [Story Title]\`
-9. Update the PRD to set \`passes: true\` for the completed story
-10. Append your progress to \`relentless/features/<feature>/progress.txt\`
+---
 
 ## Progress Report Format
 
-APPEND to progress.txt (never replace, always append):
+APPEND to progress.txt:
 \`\`\`
 ## [Date/Time] - [Story ID]
 - What was implemented
 - Files changed
-- **Learnings for future iterations:**
-  - Patterns discovered
-  - Gotchas encountered
-  - Useful context
+- Learnings for future iterations
 ---
 \`\`\`
 
-## Quality Requirements
-
-- ALL commits must pass your project's quality checks (typecheck, lint, test)
-- Do NOT commit broken code
-- Keep changes focused and minimal
-- Follow existing code patterns
-- Review code before modifying it
+---
 
 ## Stop Condition
 
-After completing a user story, check if ALL stories have \`passes: true\`.
+After completing a story, check if ALL stories have \`passes: true\`.
 
-If ALL stories are complete and passing, reply with:
+If ALL complete:
+\`\`\`
 <promise>COMPLETE</promise>
+\`\`\`
 
-If there are still stories with \`passes: false\`, end your response normally (another iteration will pick up the next story).
-
-## Important
-
-- Work on ONE story per iteration
-- Review existing code before implementing
-- Commit frequently
-- Keep CI green
+Otherwise, end normally (next iteration continues).
 `;
 
 /**

package/src/tui/App.tsx

@@ -5,7 +5,7 @@
  */
 
 import React from "react";
-import { Box, Text } from "ink";
+import { Box, Text, useStdout } from "ink";
 import { Header } from "./components/Header.js";
 import { ProgressBar } from "./components/ProgressBar.js";
 import { CurrentStory } from "./components/CurrentStory.js";
@@ -20,8 +20,23 @@ interface AppProps {
 }
 
 export function App({ state }: AppProps): React.ReactElement {
+  const { stdout } = useStdout();
+  const terminalRows = stdout.rows ?? 24;
+  
   const completedCount = state.stories.filter((s) => s.passes).length;
   const totalCount = state.stories.length;
+  
+  // Calculate available rows for stories based on terminal height
+  // Chrome: Header(2) + Feature/Progress(2) + CurrentStory(2) + AgentOutputHeader(1) + AgentStatusFooter(2) + Padding(2) = ~11 lines
+  // AgentOutput: 6 lines
+  // Remaining space for stories
+  const chromeHeight = 11;
+  const agentOutputLines = 6;
+  const availableForStories = Math.max(8, terminalRows - chromeHeight - agentOutputLines);
+  
+  // Calculate story rows needed for 2-column layout
+  const storyRows = Math.ceil(totalCount / 2);
+  const maxStoryRows = Math.min(storyRows, availableForStories);
 
   return (
     <Box flexDirection="column" width="100%">
@@ -50,13 +65,13 @@ export function App({ state }: AppProps): React.ReactElement {
       </Box>
 
       {/* Agent output */}
-      <AgentOutput lines={state.outputLines} maxLines={8} />
+      <AgentOutput lines={state.outputLines} maxLines={agentOutputLines} />
 
       {/* Story grid */}
       <StoryGrid
         stories={state.stories}
         currentStoryId={state.currentStory?.id}
-        maxRows={8}
+        maxRows={maxStoryRows}
       />
 
       {/* Agent status footer */}

package/src/tui/components/StoryGrid.tsx

@@ -37,14 +37,43 @@ export function StoryGrid({
     rows.push(row);
   }
 
-  // Constrain to maxRows
-  const visibleRows = maxRows ? rows.slice(0, maxRows) : rows;
+  // Window around current story to show context
+  let visibleRows = rows;
+  let startRow = 0;
+  let endRow = rows.length;
+
+  if (maxRows && rows.length > maxRows) {
+    // Find the row containing the current story
+    const currentRowIdx = currentStoryId
+      ? rows.findIndex((row) => row.some((story) => story.id === currentStoryId))
+      : -1;
+
+    if (currentRowIdx >= 0) {
+      // Center the window around the current story
+      const half = Math.floor(maxRows / 2);
+      startRow = Math.max(0, currentRowIdx - half);
+      
+      // Adjust if window goes past the end
+      if (startRow + maxRows > rows.length) {
+        startRow = Math.max(0, rows.length - maxRows);
+      }
+      
+      endRow = Math.min(rows.length, startRow + maxRows);
+      visibleRows = rows.slice(startRow, endRow);
+    } else {
+      // No current story, just show first N rows
+      visibleRows = rows.slice(0, maxRows);
+      endRow = Math.min(rows.length, maxRows);
+    }
+  }
 
   return (
     <Box flexDirection="column" paddingY={1}>
       <Box paddingX={1}>
         <Text color={colors.dim} bold>
-          ── Stories ({stories.length}) ──
+          {visibleRows.length < rows.length
+            ? `── Stories (rows ${startRow + 1}-${endRow} of ${rows.length}, ${stories.length} total) ──`
+            : `── Stories (${stories.length}) ──`}
         </Text>
       </Box>
       <Box flexDirection="column" paddingX={1}>