Skip to content

refactor(humaninloop): bring plan-architect to AGENT-GUIDELINES compliance#68

Open
deepeshBodh wants to merge 2 commits into
mainfrom
refactor/plan-architect-compliance
Open

refactor(humaninloop): bring plan-architect to AGENT-GUIDELINES compliance#68
deepeshBodh wants to merge 2 commits into
mainfrom
refactor/plan-architect-compliance

Conversation

@deepeshBodh

Copy link
Copy Markdown
Owner

Summary

  • Strip all workflow-coupled content from plan-architect.md (256 → 102 lines, 70 additions / 224 deletions)
  • Remove 5 anti-leak violations: phase branching, 10+ hardcoded paths, sibling agent reference (Devil's Advocate), context file schema, sequencing knowledge
  • Remove 4 forbidden sections: Phase Behaviors, Report Format, How You Operate, Reading the Context
  • Add 3 <example> blocks to description for proper triggering
  • Add missing "What You Produce" section listing artifact types
  • Strengthen Core Identity with specific experiential beliefs that shape concrete judgments
  • Fold brownfield awareness into Core Identity and What You Embrace as character traits
  • Use namespace syntax (humaninloop:patterns-*) for all skill cross-references
  • Expand Quality Standards with architectural specifics (bidirectional relationships, state machine completeness, PII marking, impedance mismatches)

Audit result: PASS WITH NOTES (from REJECT with 11 critical issues)

Test plan

  • Verify skill delegation: give agent a planning task and confirm it invokes humaninloop:patterns-technical-decisions rather than improvising
  • Verify persona fidelity: give agent a task tempting single-option decisions and confirm it rejects
  • Verify workflow independence: invoke from a supervisor prompt and confirm no coupling leaks

🤖 Generated with Claude Code

deepeshBodh and others added 2 commits February 7, 2026 21:45
… compliance

Strip all workflow-coupled content (phase branching, hardcoded paths,
sibling awareness, schema knowledge, sequencing) and restructure as a
clean persona agent that delegates process to its existing skills.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
…e plan-architect decoupling

The plan-architect refactoring removed workflow-coupled procedural content
per AGENT-GUIDELINES.md, creating regression risks. This skill captures
the removed planning knowledge: evolution roadmap integration, spec marker
resolution, quickstart guide structure, planner report population, and
phase quality gates. Supervisor (plan.md) updated to reference the skill
in all three planning phases.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@deepeshBodh deepeshBodh reopened this Feb 16, 2026
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