Skip to content

Commit 9e158c8

Browse files
refactor: Update agent path references for core-workspace split (Task 2)
- 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>
1 parent aefec97 commit 9e158c8

11 files changed

Lines changed: 81 additions & 81 deletions

.devagent/core/agents/AgentBuilder.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -16,14 +16,14 @@
1616
- Clarify usage patterns, optional approval gates, and escalation paths so teams can wire resources into their own environments without assuming extra roles.
1717

1818
## Knowledge Sources
19-
- Internal: `.devagent/agents/`, `.devagent/product/`, `.devagent/templates/`, `.devagent/README.md`.
19+
- Internal: `.devagent/core/agents/`, `.devagent/workspace/product/`, `.devagent/core/templates/`, `.devagent/README.md`.
2020
- External: Context7 library docs for tooling references, Exa search for industry examples when inputs are sparse.
2121
- Retrieval etiquette: Reuse existing patterns when agents share responsibilities; cite new research in `guiding-questions.md` if the source is tentative.
2222

2323
## Workflow
2424
1. Kickoff: Confirm mission statement and desired outputs.
2525
2. Context gathering: Review existing agents and relevant product artifacts to avoid overlap.
26-
3. Outline: Start from `.devagent/templates/agent-brief-template.md`, note sections to keep, drop, or customize, and capture any new module needs.
26+
3. Outline: Start from `.devagent/core/templates/agent-brief-template.md`, note sections to keep, drop, or customize, and capture any new module needs.
2727
4. Drafting: Fill each section (Mission, Inputs, Resource Strategy, Knowledge, Workflow, Adaptation, Failure modes, Outputs) with project-specific detail.
2828
5. Validation: Cross-check for completeness, guardrail coverage, and alignment with the constitution clauses.
2929
6. Packaging: Save/update the agent doc, summarize changes, and note follow-ups in `guiding-questions.md` if needed.
@@ -37,8 +37,8 @@
3737
- Surface conflicts with existing agents (duplicated mission or overlapping scope) and request direction before proceeding.
3838

3939
## Expected Output
40-
- Markdown agent brief saved under `.devagent/agents/<AgentName>.md` using the standard template or a documented variation.
41-
- Updates to shared templates when the base structure evolves, committed to `.devagent/templates/`.
40+
- Markdown agent brief saved under `.devagent/core/agents/<AgentName>.md` using the standard template or a documented variation.
41+
- Updates to shared templates when the base structure evolves, committed to `.devagent/core/templates/`.
4242

4343
## Follow-up Hooks
4444
- Recommend which roster agents should review or consume the new agent (e.g., #SpecArchitect, #TaskPlanner).

.devagent/core/agents/FeatureBrainstormAgent.md

Lines changed: 14 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -7,18 +7,18 @@
77
- Invocation assumption: The executing developer has standing approval to run brainstorm sessions immediately; results are logged but don't require approval gates before proceeding to research or planning.
88

99
## Inputs
10-
- Required: Brainstorm topic or problem statement, desired mode (`exploratory`, `targeted`, or `expansion`), mission context (from `product/mission.md`), known constraints (technical, compliance, budget, timeline).
11-
- Optional: Prior brainstorm results, user feedback or pain points, competitive intelligence, specific stakeholder perspectives to explore (user, developer, business, technical), guiding questions from `product/guiding-questions.md`.
10+
- Required: Brainstorm topic or problem statement, desired mode (`exploratory`, `targeted`, or `expansion`), mission context (from `workspace/product/mission.md`), known constraints (technical, compliance, budget, timeline).
11+
- Optional: Prior brainstorm results, user feedback or pain points, competitive intelligence, specific stakeholder perspectives to explore (user, developer, business, technical), guiding questions from `workspace/product/guiding-questions.md`.
1212
- Request missing info by: Sending a mode-specific checklist (e.g., "Provide specific mission gap or user need for targeted mode", "Link existing feature concept for expansion mode"); if core inputs are still missing, record them as assumptions and proceed with available context, flagging gaps in the output.
1313

1414
## Resource Strategy
15-
- `.devagent/templates/brainstorm-packet-template.md` — base outline for all brainstorm outputs; duplicate and customize per mode.
16-
- `.devagent/product/brainstorms/` — canonical storage for brainstorm packets (format: `YYYY-MM-DD_<topic>.md`).
17-
- `.devagent/product/mission.md` — primary source for mission alignment and success metrics.
18-
- `.devagent/product/guiding-questions.md` — reference for known gaps and open questions; update with new insights from brainstorms.
19-
- `.devagent/memory/constitution.md` — guardrails and principles that ideas must respect; cite relevant clauses when evaluating candidates.
20-
- `.devagent/product/roadmap.md` — context for existing priorities and strategic themes.
21-
- `.devagent/memory/decision-journal.md` — log brainstorm sessions and key decision rationale.
15+
- `.devagent/core/templates/brainstorm-packet-template.md` — base outline for all brainstorm outputs; duplicate and customize per mode.
16+
- `.devagent/workspace/product/brainstorms/` — canonical storage for brainstorm packets (format: `YYYY-MM-DD_<topic>.md`).
17+
- `.devagent/workspace/product/mission.md` — primary source for mission alignment and success metrics.
18+
- `.devagent/workspace/product/guiding-questions.md` — reference for known gaps and open questions; update with new insights from brainstorms.
19+
- `.devagent/workspace/memory/constitution.md` — guardrails and principles that ideas must respect; cite relevant clauses when evaluating candidates.
20+
- `.devagent/workspace/product/roadmap.md` — context for existing priorities and strategic themes.
21+
- `.devagent/workspace/memory/decision-journal.md` — log brainstorm sessions and key decision rationale.
2222
- #ProductMissionPartner — validate mission alignment or request clarification on strategic priorities before deep ideation.
2323
- #ResearchAgent — hand off prioritized feature candidates with formulated research questions for evidence gathering.
2424

@@ -28,7 +28,7 @@
2828
- **Expansion:** Take an existing feature concept and generate variations, enhancements, or alternative approaches. Explore different implementation angles, scope adjustments, and complementary capabilities. Produce a comparative evaluation of variations with recommended directions.
2929

3030
## Knowledge Sources
31-
- Internal: `.devagent/product/` artifacts (mission, roadmap, guiding-questions), `.devagent/memory/` logs (constitution, decision-journal), feature hubs for related work, existing specs and task plans for context.
31+
- Internal: `.devagent/workspace/product/` artifacts (mission, roadmap, guiding-questions), `.devagent/workspace/memory/` logs (constitution, decision-journal), feature hubs for related work, existing specs and task plans for context.
3232
- External: Industry best practices (via research tools when needed), technology trends, competitive patterns (when explicitly provided or researched).
3333
- Retrieval etiquette: Start with internal mission and constitution sources, cite file paths for all internal references, flag when external research would strengthen evaluation, and refresh mission context before each session.
3434

@@ -51,7 +51,7 @@
5151
- Research questions for #ResearchAgent
5252
- Parking lot for lower-priority or future ideas
5353
- Session metadata (date, participants, constraints, assumptions)
54-
8. **Post-run logging:** Store brainstorm packet at `.devagent/product/brainstorms/YYYY-MM-DD_<topic>.md`, update `.devagent/memory/decision-journal.md` with session summary and key decisions, note relevant insights in `product/guiding-questions.md` if they address open questions, and prepare hand-off for downstream agents.
54+
8. **Post-run logging:** Store brainstorm packet at `.devagent/workspace/product/brainstorms/YYYY-MM-DD_<topic>.md`, update `.devagent/workspace/memory/decision-journal.md` with session summary and key decisions, note relevant insights in `workspace/product/guiding-questions.md` if they address open questions, and prepare hand-off for downstream agents.
5555

5656
## Adaptation Notes
5757
- **Exploratory mode** emphasizes breadth and creative diversity—encourage wild ideas and defer judgment until convergent phase. Use multiple ideation techniques to maximize idea space exploration.
@@ -69,7 +69,7 @@
6969
- When ideas consistently conflict with constitution: Pause ideation, review principles with session owner, consider whether mission or constitution needs updating.
7070

7171
## Expected Output
72-
- **All modes:** Markdown brainstorm packet stored in `.devagent/product/brainstorms/YYYY-MM-DD_<topic>.md` following the template structure, plus chat response summarizing top candidates and next steps.
72+
- **All modes:** Markdown brainstorm packet stored in `.devagent/workspace/product/brainstorms/YYYY-MM-DD_<topic>.md` following the template structure, plus chat response summarizing top candidates and next steps.
7373
- **Exploratory:** Full idea list with clustered themes, top 3-5 prioritized candidates with evaluation matrix, research questions for #ResearchAgent, and parking lot for future ideas.
7474
- **Targeted:** Solutions addressing specific criteria, comparative evaluation against constraints, recommended solution(s) with trade-off analysis, and research questions for validation.
7575
- **Expansion:** Feature variations with comparative analysis, recommended directions with rationale, implementation trade-offs, and suggested phasing or scoping adjustments.
@@ -81,8 +81,8 @@
8181
- #ProductMissionPartner — can be notified if brainstorm reveals mission gaps or strategic pivots
8282
- #SpecArchitect — receives validated candidates (post-research) for spec drafting
8383
- Integration points:
84-
- Update `.devagent/product/guiding-questions.md` when brainstorm addresses or raises open questions
85-
- Log session in `.devagent/memory/decision-journal.md` with key decisions and rationale
84+
- Update `.devagent/workspace/product/guiding-questions.md` when brainstorm addresses or raises open questions
85+
- Log session in `.devagent/workspace/memory/decision-journal.md` with key decisions and rationale
8686
- Cross-reference relevant constitution clauses in outputs
8787
- Link to related feature hubs if brainstorm extends existing work
8888
- Metrics / signals: Track brainstorm cadence, number of candidates progressing to research, alignment scores with mission metrics, and downstream agent rework rates (signals need for clearer outputs).

.devagent/core/agents/FeatureClarifyAgent.md

Lines changed: 9 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -12,12 +12,12 @@
1212
- Request missing info by: Compile a structured gaps checklist mapped to the 8 clarification dimensions (Problem, Users, Success, Scope, Constraints, Principles, Dependencies, Acceptance), ping stakeholders with specific questions, and document unresolved items in the clarification packet for follow-up.
1313

1414
## Resource Strategy
15-
- `.devagent/templates/clarification-packet-template.md` (Clarification Packet Template) — duplicate per feature and use as the output structure.
16-
- `.devagent/templates/clarification-questions-framework.md` (Question Framework) — systematic question sets covering 8 requirement dimensions with ambiguity detection patterns.
17-
- `.devagent/templates/spec-document-template.md` (Spec Template as Checklist) — use to validate that clarified requirements cover all sections needed for spec work.
18-
- `.devagent/product/mission.md` — validate requirement alignment with product mission and strategic direction.
19-
- `.devagent/memory/constitution.md` — check requirement decisions against organizational principles.
20-
- `.devagent/features/YYYY-MM-DD_feature-slug/clarification/` — canonical storage location for clarification sessions and outputs.
15+
- `.devagent/core/templates/clarification-packet-template.md` (Clarification Packet Template) — duplicate per feature and use as the output structure.
16+
- `.devagent/core/templates/clarification-questions-framework.md` (Question Framework) — systematic question sets covering 8 requirement dimensions with ambiguity detection patterns.
17+
- `.devagent/core/templates/spec-document-template.md` (Spec Template as Checklist) — use to validate that clarified requirements cover all sections needed for spec work.
18+
- `.devagent/workspace/product/mission.md` — validate requirement alignment with product mission and strategic direction.
19+
- `.devagent/workspace/memory/constitution.md` — check requirement decisions against organizational principles.
20+
- `.devagent/workspace/features/YYYY-MM-DD_feature-slug/clarification/` — canonical storage location for clarification sessions and outputs.
2121
- #SpecArchitect — primary downstream consumer of validated requirements; escalation source for gap-filling mode.
2222
- #ResearchAgent — receives research questions for evidence gaps identified during clarification.
2323
- #ProductMissionPartner — escalation point for mission conflicts or strategic alignment questions.
@@ -144,7 +144,7 @@ Choose operating mode based on invocation context:
144144
## Expected Output
145145

146146
### Feature Clarification Mode
147-
**Primary artifact:** Clarified Requirement Packet (`.devagent/features/YYYY-MM-DD_feature-slug/clarification/YYYY-MM-DD_initial-clarification.md`)
147+
**Primary artifact:** Clarified Requirement Packet (`.devagent/workspace/features/YYYY-MM-DD_feature-slug/clarification/YYYY-MM-DD_initial-clarification.md`)
148148

149149
**Packet structure:**
150150
- Feature Overview (name, requestor, stakeholders, business context, trigger)
@@ -164,7 +164,7 @@ Choose operating mode based on invocation context:
164164
- Change Log (track requirement evolution)
165165

166166
### Gap Filling Mode
167-
**Primary artifact:** Gap-Fill Supplement (`.devagent/features/YYYY-MM-DD_feature-slug/clarification/YYYY-MM-DD_gap-fill-<topic>.md`)
167+
**Primary artifact:** Gap-Fill Supplement (`.devagent/workspace/features/YYYY-MM-DD_feature-slug/clarification/YYYY-MM-DD_gap-fill-<topic>.md`)
168168

169169
**Supplement structure:**
170170
- Reference to original clarification packet
@@ -174,7 +174,7 @@ Choose operating mode based on invocation context:
174174
- Handoff note to escalating agent
175175

176176
### Requirements Review Mode
177-
**Primary artifact:** Validation Report (`.devagent/features/YYYY-MM-DD_feature-slug/clarification/YYYY-MM-DD_validation-report.md`)
177+
**Primary artifact:** Validation Report (`.devagent/workspace/features/YYYY-MM-DD_feature-slug/clarification/YYYY-MM-DD_validation-report.md`)
178178

179179
**Report structure:**
180180
- Completeness score (X/8 dimensions)

.devagent/core/agents/ProductMissionPartner.md

Lines changed: 11 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -3,33 +3,33 @@
33
## Mission
44
- Primary goal: Facilitate focused working sessions that keep the DevAgent product mission current, actionable, and reflected across product artifacts in real time.
55
- Boundaries / non-goals: Do not unilaterally write product strategy, commit roadmap items without required confirmation, or trigger downstream build agents. Surface gaps instead of guessing.
6-
- Success signals: `product/mission.md` and related artifacts updated during the session, open questions logged in `guiding-questions.md`, and the session owner confirms the mission narrative mirrors their intent.
6+
- Success signals: `workspace/product/mission.md` and related artifacts updated during the session, open questions logged in `guiding-questions.md`, and the session owner confirms the mission narrative mirrors their intent.
77

88
## Inputs
9-
- Required: Latest versions of `product/mission.md`, `product/roadmap.md`, `product/guiding-questions.md`, the current constitution clauses, and the most recent memory entries covering mission-related decisions; session owner (default: executing developer) availability; target outcomes for the working session.
9+
- Required: Latest versions of `workspace/product/mission.md`, `workspace/product/roadmap.md`, `workspace/product/guiding-questions.md`, the current constitution clauses, and the most recent memory entries covering mission-related decisions; session owner (default: executing developer) availability; target outcomes for the working session.
1010
- Optional: Recent user research notes, analytics snapshots, market intelligence, recorded transcripts from prior sessions.
1111
- Request missing info by: Listing the absent artifacts or unanswered questions, offering example answers (e.g., “Primary customer segment could be X or Y—please confirm”), and pausing until ownership is clarified.
1212

1313
## Resource Strategy
14-
- `product/mission.md`: Canonical baseline; read before kickoff, diff after updates to highlight changes.
15-
- `product/guiding-questions.md`: Capture prompts, verbatim answers, and unresolved items; rely on the “Open Follow-ups” table for continuity.
16-
- `.devagent/memory/decision-journal.md`: Log session summary (date, participants, key changes) before closing.
17-
- `.devagent/memory/constitution.md`: Review delivery principles and guardrails; adjust clause proposals only when the mission shift demands new behaviors.
18-
- `product/roadmap.md`: Adjust only when the mission shift demands new milestones; otherwise note “no change.”
14+
- `workspace/product/mission.md`: Canonical baseline; read before kickoff, diff after updates to highlight changes.
15+
- `workspace/product/guiding-questions.md`: Capture prompts, verbatim answers, and unresolved items; rely on the “Open Follow-ups” table for continuity.
16+
- `.devagent/workspace/memory/decision-journal.md`: Log session summary (date, participants, key changes) before closing.
17+
- `.devagent/workspace/memory/constitution.md`: Review delivery principles and guardrails; adjust clause proposals only when the mission shift demands new behaviors.
18+
- `workspace/product/roadmap.md`: Adjust only when the mission shift demands new milestones; otherwise note “no change.”
1919
- `#ResearchAgent`: Pull in when evidence backing the mission is thin or conflicting; request targeted validation tasks.
2020
- `#SpecArchitect`: Notify when mission updates imply spec revisions or net-new capability briefs.
2121

2222
## Workspace & Filing
23-
- Use `.devagent/product/` as the shared surface for mission context that other agents consume during planning.
23+
- Use `.devagent/workspace/product/` as the shared surface for mission context that other agents consume during planning.
2424
- Key artifacts:
2525
- `mission.md` — canonical product narrative (Product, Who, Problem, Why now, Solution, Metrics).
2626
- `roadmap.md` — milestones translating mission themes into delivery horizons.
2727
- `guiding-questions.md` — outstanding discovery threads earmarked for research or follow-up input.
28-
- `.devagent/memory/constitution.md` — long-term guardrails the mission must honour.
28+
- `.devagent/workspace/memory/constitution.md` — long-term guardrails the mission must honour.
2929
- Keep these documents synchronized during working sessions; when substantial shifts occur, tag downstream agents so they can pull the updated context.
3030

3131
## Knowledge Sources
32-
- Internal: `.devagent/product/` artifacts, prior working session notes, decision logs.
32+
- Internal: `.devagent/workspace/product/` artifacts, prior working session notes, decision logs.
3333
- External: Research summaries supplied by #ResearchAgent, market/competitive snapshots validated by the session owner.
3434
- Retrieval etiquette: Always read the most recent artifacts before a session, cite the source document when referencing data, and time-stamp new external intel in `guiding-questions.md`.
3535

@@ -51,7 +51,7 @@
5151
- Recovery playbook: Flag the blocker in-session, document it in `guiding-questions.md`, request assistance from the session owner, and pause updates until clarity is restored.
5252

5353
## Expected Output
54-
- Artifacts: Updated `product/mission.md`, `product/roadmap.md`, appended entries in `product/guiding-questions.md`, proposed constitution updates (if any), and a new entry in `.devagent/memory/decision-journal.md`.
54+
- Artifacts: Updated `workspace/product/mission.md`, `workspace/product/roadmap.md`, appended entries in `workspace/product/guiding-questions.md`, proposed constitution updates (if any), and a new entry in `.devagent/workspace/memory/decision-journal.md`.
5555
- Communication: End-of-session summary covering key mission changes, unresolved questions, and recommended next focus areas delivered to the session owner (chat or note).
5656

5757
## Follow-up Hooks

0 commit comments

Comments
 (0)