Skip to content

feat: Hound agent, auto-refresh prompts, model selection#2

Merged
paraddox merged 9 commits intomainfrom
ralph
Jan 13, 2026
Merged

feat: Hound agent, auto-refresh prompts, model selection#2
paraddox merged 9 commits intomainfrom
ralph

Conversation

@paraddox
Copy link
Copy Markdown
Owner

@paraddox paraddox commented Jan 13, 2026

Summary

  • Hound Agent: New periodic code review agent that runs every 20 closed tasks and before Overseer
  • Auto-refresh prompts: Agent prompts are updated from templates on every container start
  • Model selection: Configurable model for coder/overseer agents per project
  • Container cleanup: Containers are removed (not just stopped) on server shutdown
  • Docker auto-build: Image is built automatically if it doesn't exist
  • Ralph Playbook: Session continuity methodology integrated into prompts

Changes

New Features

  • Hound agent reviews last 30 closed tasks for incomplete implementations
  • Prompts refresh from templates every container start (ensures updates propagate)
  • Project settings modal for model selection (Sonnet/Opus)
  • Auto-build Docker image on first start if missing
  • Ralph artifacts (AGENTS.md, IMPLEMENTATION_PLAN.md, IMPLEMENTATION_HISTORY.md)

Improvements

  • Enhanced coding/overseer prompts with Ralph Playbook methodology
  • Containers removed on shutdown for clean restarts
  • Fixed file permission issues with container-created files

Test plan

  • Start a project, verify prompts are refreshed from templates
  • Close 20+ tasks, verify Hound agent triggers
  • Close all tasks, verify Hound runs before Overseer
  • Stop server with Ctrl+C, verify containers are removed
  • Start fresh without Docker image, verify it builds automatically
  • Change model in settings, verify next session uses new model

🤖 Generated with Claude Code

lswSoso and others added 9 commits January 13, 2026 16:29
Add Ralph-style artifacts and workflow discipline:
- AGENTS.md: Operational guide created by initializer (commands, patterns, gotchas)
- IMPLEMENTATION_PLAN.md: Per-feature task breakdown with gap analysis
- IMPLEMENTATION_HISTORY.md: Archive of completed feature plans

Workflow changes:
- Coding agent now reads artifacts before starting
- Mandatory gap analysis + task breakdown before implementation
- STRICT validation gate (lint/typecheck MUST pass before closing)
- Discoveries logged to artifacts for future sessions

This addresses the "cold start" problem where each session rediscovered
commands and patterns. Now operational knowledge persists across sessions.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Add Blockers section to IMPLEMENTATION_PLAN.md template
- Add size limit guidance (< 100 lines) for AGENTS.md
- Add rolling window for IMPLEMENTATION_HISTORY.md (tail -50/100)
- Make archiving crash-safe (only delete after successful archive)
- Document size limits in project_claude.md.template

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Add UI and backend support to select Claude model (Opus 4.5 or Sonnet 4.5)
for coder and overseer agents. Initializer and assistant agents remain
hardcoded to Opus 4.5.

Backend:
- agent_app.py reads model from prompts/.agent_config.json at runtime
- Added PATCH/GET /api/projects/{name}/settings endpoints
- Added agent_model field to ProjectSummary and ProjectDetail schemas

Frontend:
- Added ProjectSettingsModal with radio button model selection
- Added settings (gear) icon in ControlBar
- Added useUpdateProjectSettings hook and API client functions

Changes apply to next agent session without container recreation.
Default model is Sonnet 4.5 (cost effective).

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Add automatic image building when starting a container if the
zerocoder-project image is not found. This prevents 503 errors
when the image has been removed or on fresh installs.

- Added image_exists() to check if image is present
- Added build_image() to build from Dockerfile.project
- Added ensure_image_exists() called before docker run
- 10 minute timeout for build process

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Ensures template updates propagate to all projects automatically.
Refreshes coding, overseer, and initializer prompts while preserving
app_spec.txt and CLAUDE.md user content.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Ensures clean state when server restarts, forcing prompts to refresh.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- New hound_prompt.template.md for reviewing closed tasks
- Hound runs every 20 closed tasks (periodic review)
- Hound runs before Overseer when all tasks complete
- Reviews last 30 closed tasks for incomplete implementations
- Reopens tasks with detailed comments if found incomplete
- Works for both new projects and existing repos
- State tracked in .hound_state.json per project

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Container creates files with UID 1001, which host user can't overwrite.
Solution: unlink() the file first (requires dir write permission, not file).

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@paraddox paraddox changed the title feat: Add model selection for coder/overseer agents feat: Hound agent, auto-refresh prompts, model selection Jan 13, 2026
@paraddox paraddox merged commit 459b091 into main Jan 13, 2026
0 of 2 checks passed
@paraddox paraddox deleted the ralph branch January 13, 2026 22:04
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants