Skip to content

Update TechStackAgent documentation to reflect new template location …#8

Merged
jaruesink merged 12 commits intomainfrom
feature/core-workspace-split
Oct 1, 2025
Merged

Update TechStackAgent documentation to reflect new template location …#8
jaruesink merged 12 commits intomainfrom
feature/core-workspace-split

Conversation

@jaruesink
Copy link
Copy Markdown
Contributor

@jaruesink jaruesink commented Oct 1, 2025

…and remove obsolete tech stack template file. The changes ensure clarity in documentation sources and streamline the tech stack documentation process.

Summary by CodeRabbit

  • New Features

    • Introduced Core–Workspace split for clearer separation of portable kit and project artifacts.
    • Added Agent Roster documentation and a refreshed Task Planner guide under core.
    • Created feature hubs for Core–Workspace Split and Agent Execution Directive, with implementation plans.
  • Documentation

    • Updated README and AGENTS references to new core/workspace paths.
    • Revised all agent sheets and templates to workspace-based locations.
  • Refactor

    • Migrated paths from legacy .devagent structure to .devagent/core and .devagent/workspace.
    • Removed deprecated Task Planner spec in old location.
  • Chores

    • Added detailed task plans and validation steps for migration and documentation updates.

jaruesink and others added 12 commits October 1, 2025 14:13
…and remove obsolete tech stack template file. The changes ensure clarity in documentation sources and streamline the tech stack documentation process.
…ecution. Key updates include redefining the primary goal to emphasize concrete implementation tasks, refining workflow steps to prioritize execution-focused outputs, and clarifying boundaries to exclude process tasks. This ensures that developers can implement plans with minimal clarification and that validation is embedded within tasks.
…w directory structure. Key updates include:

- Updated resource strategy to reflect changes in task storage paths, emphasizing the use of `workspace/` for project-specific artifacts.
- Revised output packaging instructions to ensure task prompt files are created directly in the new structure.
- Clarified validation and communication expectations for task outputs.

These changes enhance clarity and usability for developers implementing task prompts within the updated DevAgent framework.
Relocate all 12 agent markdown files from .devagent/agents/ to .devagent/core/agents/
to establish the portable agent kit. This includes preserving the codegen/ subdirectory
structure for CodegenBackgroundAgent.md.

Part of core/workspace split to enable 'copy this folder' DevAgent adoption pattern.

Co-authored-by: Jake Ruesink <jaruesink@gmail.com>
Relocate all 9 template markdown files from .devagent/templates/ to .devagent/core/templates/
to establish the reusable template library. These templates provide standardized formats
for agent outputs and project artifacts.

Part of core/workspace split to enable portable DevAgent kit distribution.

Co-authored-by: Jake Ruesink <jaruesink@gmail.com>
Relocate the feature hub template from .devagent/features/_template/ to
.devagent/core/templates/feature-hub-template/ to position it as a reusable
scaffold in the portable agent kit.

The feature hub template provides the standard structure for organizing feature
development work including research and spec subdirectories.

Part of core/workspace split to enable easy feature hub creation across projects.

Co-authored-by: Jake Ruesink <jaruesink@gmail.com>
Relocate project-specific working files from flat .devagent/ directories into
.devagent/workspace/ subdirectories:

- product/ → workspace/product/ (mission.md, roadmap.md, guiding-questions.md)
- memory/ → workspace/memory/ (constitution.md, decision-journal.md, tech-stack.md, overview.md)
- features/README.md → workspace/features/README.md
- research/ → workspace/research/ (research markdown files)

This separates project-specific artifacts from the portable agent kit, enabling
clean cross-project DevAgent adoption by copying only the core/ directory.

Part of core/workspace split to establish clear 'copy vs customize' boundaries.

Co-authored-by: Jake Ruesink <jaruesink@gmail.com>
…dated directory structure. Key changes include:

- Adjusted resource strategy to utilize `workspace/` for project-specific artifacts.
- Updated output packaging instructions for task prompt files to fit the new structure.
- Enhanced clarity on validation and communication expectations for task outputs.

These updates aim to streamline the task prompt creation process and enhance usability for developers within the DevAgent framework.
…y/devagent into feature/core-workspace-split
…es as part of the core/workspace split. This cleanup eliminates obsolete documentation and tasks related to the execution directive, streamlining the DevAgent framework for improved usability and clarity in project setup.
- Updated all agent instruction files to use new path conventions
- Template paths: .devagent/agents/ → .devagent/core/agents/
- Template paths: .devagent/templates/ → .devagent/core/templates/
- Working paths: .devagent/product/ → .devagent/workspace/product/
- Working paths: .devagent/memory/ → .devagent/workspace/memory/
- Working paths: .devagent/features/ → .devagent/workspace/features/
- Working paths: .devagent/research/ → .devagent/workspace/research/

Files updated (11):
- AgentBuilder.md
- FeatureBrainstormAgent.md
- FeatureClarifyAgent.md
- ProductMissionPartner.md
- ResearchAgent.md
- SpecArchitect.md
- TaskExecutor.md
- TaskPlanner.md
- TechStackAgent.md
- UpdateConstitution.md
- codegen/CodegenBackgroundAgent.md

Validation: grep confirmed no old path patterns remain in agent files

Co-authored-by: Jake Ruesink <jaruesink@gmail.com>
- Update AGENTS.md: All 10 agent references now use .devagent/core/agents/ paths
- Create core/README.md: Comprehensive setup guide with directory structure and 5-minute setup instructions
- Create core/AGENTS.md: Portable copy of agent roster for kit completeness
- Update root README.md: Add structure section explaining core vs workspace, update all path references
- Update templates: All self-references now use workspace/ paths for outputs

This completes the documentation layer for the core-workspace split, enabling
teams to easily adopt DevAgent in new projects by copying the portable core/ kit.

Co-authored-by: Jake Ruesink <jaruesink@gmail.com>
@coderabbitai
Copy link
Copy Markdown

coderabbitai Bot commented Oct 1, 2025

Caution

Review failed

The pull request is closed.

Walkthrough

Reorganizes DevAgent into core (portable) and workspace (project) directories, updates all agent/docs/templates to new paths, removes the old TaskPlanner and adds a new TaskPlanner doc under core, and adds feature hubs for “Core-Workspace Split” and “Agent Execution Directive,” plus updated top-level and core AGENTS/README docs.

Changes

Cohort / File(s) Summary of Changes
Core & Root Documentation Updates
.devagent/core/README.md, .devagent/core/AGENTS.md, README.md, AGENTS.md
Added core README and AGENTS; updated root README and AGENTS to reflect core/workspace split, new directory maps, setup, and agent doc locations.
Agent Instruction Sheets (path migration + adds/removes)
.devagent/core/agents/AgentBuilder.md, .devagent/core/agents/FeatureBrainstormAgent.md, .devagent/core/agents/FeatureClarifyAgent.md, .devagent/core/agents/ProductMissionPartner.md, .devagent/core/agents/ResearchAgent.md, .devagent/core/agents/SpecArchitect.md, .devagent/core/agents/TaskExecutor.md, .devagent/core/agents/TaskPlanner.md, .devagent/core/agents/TaskPromptBuilder.md, .devagent/core/agents/TechStackAgent.md, .devagent/core/agents/UpdateConstitution.md, .devagent/core/agents/codegen/CodegenBackgroundAgent.md, .devagent/agents/TaskPlanner.md
Migrated internal references from legacy .devagent/... to .devagent/core/... and .devagent/workspace/...; added new TaskPlanner doc under core; removed old TaskPlanner at .devagent/agents/TaskPlanner.md. No logic changes; primarily path and storage-location updates; some explicit “write file” instruction added for TaskPromptBuilder.
Templates (path updates)
.devagent/core/templates/brainstorm-packet-template.md, .devagent/core/templates/clarification-packet-template.md, .devagent/core/templates/research-packet-template.md, .devagent/core/templates/spec-document-template.md, .devagent/core/templates/task-plan-template.md, .devagent/core/templates/task-prompt-template.md
Updated template references from feature-level to workspace paths; adjusted task-plan template repeat structure line; set template source paths under core/templates; minor formatting tweaks.
Workspace Feature: Core-Workspace Split
.devagent/workspace/features/2025-10-01_core-workspace-split/README.md, .devagent/workspace/features/2025-10-01_core-workspace-split/spec/2025-10-01_core-workspace-split-spec.md, .devagent/workspace/features/2025-10-01_core-workspace-split/tasks/2025-10-01_implementation-plan.md, .devagent/workspace/features/2025-10-01_core-workspace-split/tasks/2025-10-01_task-1-directory-structure.md, .devagent/workspace/features/2025-10-01_core-workspace-split/tasks/2025-10-01_task-2-agent-path-updates.md, .devagent/workspace/features/2025-10-01_core-workspace-split/tasks/2025-10-01_task-3-documentation.md
Added feature hub, spec, and task plans detailing the split, directory moves, path updates, validation steps, risks, and acceptance criteria.
Workspace Feature: Agent Execution Directive
.devagent/workspace/features/2025-10-01_agent-execution-directive/README.md, .devagent/workspace/features/2025-10-01_agent-execution-directive/tasks/2025-10-01_execution-directive-task-plan.md
Added feature hub and implementation plan describing a standard “Execution Directive” to be embedded in 12 agent sheets; defines scope, tasks, and validation.

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~25 minutes

Possibly related PRs

✨ Finishing touches
🧪 Generate unit tests
  • Create PR with unit tests
  • Post copyable unit tests in a comment
  • Commit unit tests in branch feature/core-workspace-split

📜 Recent review details

Configuration used: CodeRabbit UI

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 2cbeaa8 and fb4bd2c.

📒 Files selected for processing (31)
  • .devagent/agents/TaskPlanner.md (0 hunks)
  • .devagent/core/AGENTS.md (1 hunks)
  • .devagent/core/README.md (1 hunks)
  • .devagent/core/agents/AgentBuilder.md (2 hunks)
  • .devagent/core/agents/FeatureBrainstormAgent.md (5 hunks)
  • .devagent/core/agents/FeatureClarifyAgent.md (4 hunks)
  • .devagent/core/agents/ProductMissionPartner.md (2 hunks)
  • .devagent/core/agents/ResearchAgent.md (3 hunks)
  • .devagent/core/agents/SpecArchitect.md (2 hunks)
  • .devagent/core/agents/TaskExecutor.md (1 hunks)
  • .devagent/core/agents/TaskPlanner.md (1 hunks)
  • .devagent/core/agents/TaskPromptBuilder.md (3 hunks)
  • .devagent/core/agents/TechStackAgent.md (7 hunks)
  • .devagent/core/agents/UpdateConstitution.md (1 hunks)
  • .devagent/core/agents/codegen/CodegenBackgroundAgent.md (6 hunks)
  • .devagent/core/templates/brainstorm-packet-template.md (1 hunks)
  • .devagent/core/templates/clarification-packet-template.md (1 hunks)
  • .devagent/core/templates/research-packet-template.md (1 hunks)
  • .devagent/core/templates/spec-document-template.md (1 hunks)
  • .devagent/core/templates/task-plan-template.md (2 hunks)
  • .devagent/core/templates/task-prompt-template.md (1 hunks)
  • .devagent/workspace/features/2025-10-01_agent-execution-directive/README.md (1 hunks)
  • .devagent/workspace/features/2025-10-01_agent-execution-directive/tasks/2025-10-01_execution-directive-task-plan.md (1 hunks)
  • .devagent/workspace/features/2025-10-01_core-workspace-split/README.md (1 hunks)
  • .devagent/workspace/features/2025-10-01_core-workspace-split/spec/2025-10-01_core-workspace-split-spec.md (1 hunks)
  • .devagent/workspace/features/2025-10-01_core-workspace-split/tasks/2025-10-01_implementation-plan.md (1 hunks)
  • .devagent/workspace/features/2025-10-01_core-workspace-split/tasks/2025-10-01_task-1-directory-structure.md (1 hunks)
  • .devagent/workspace/features/2025-10-01_core-workspace-split/tasks/2025-10-01_task-2-agent-path-updates.md (1 hunks)
  • .devagent/workspace/features/2025-10-01_core-workspace-split/tasks/2025-10-01_task-3-documentation.md (1 hunks)
  • AGENTS.md (1 hunks)
  • README.md (1 hunks)

Comment @coderabbitai help to get the list of available commands and usage tips.

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.

1 participant