Skip to content

Add junior-dev Claude plugin#13

Open
abdulrafey1 wants to merge 1 commit into
arbisoft:mainfrom
abdulrafey1:rafey/claude-junior-dev-plugin
Open

Add junior-dev Claude plugin#13
abdulrafey1 wants to merge 1 commit into
arbisoft:mainfrom
abdulrafey1:rafey/claude-junior-dev-plugin

Conversation

@abdulrafey1
Copy link
Copy Markdown

Summary

Adds a new Claude plugin, junior-dev, that bundles a research → plan → implement workflow into a single installable plugin under Claude/plugins/junior-dev/.

Type of change

  • Other (describe below) — new Claude plugin (bundle of agents + skills), a structure not yet covered by the existing agent/rule/skill categories.

What was added / changed

New directory Claude/plugins/junior-dev/ containing:

  • .claude-plugin/plugin.json — plugin manifest wiring up the agents and commands.
  • Agents (agents/):
    • orchestrator (sonnet) — main entry point; runs the researcher → planner → implementer pipeline and checks in with the user at each phase boundary.
    • researcher (sonnet) — explores the codebase for a given query and writes research.md.
    • planner (sonnet) — turns research.md into a test-driven, task-by-task plan.md.
    • implementer (haiku) — executes each task in plan.md using a strict Red → Yellow → Green TDD cycle.
  • Skills (skills/): research, plan, implement — the workflow definitions the matching agents follow.

The four agents are intentionally model-tiered (sonnet for reasoning-heavy phases, haiku for the mechanical implement loop) and stateless (memory: none), passing work between phases via the research.md / plan.md files on disk.

Checklist

  • File is placed in the correct directory (new Claude/plugins/ location)
  • Filename follows the naming convention for its type (kebab-case)
  • YAML frontmatter is present and valid (for agents and skills)
  • Content is accurate, concise, and free of typos
  • No sensitive information (credentials, internal URLs, proprietary data) is included
  • README updated if this addition warrants a mention — happy to add a Claude/plugins/ section to the top-level README if reviewers want it.

Related issues / references

None.

🤖 Generated with Claude Code

Bundles a research → plan → implement workflow as a single plugin with
four agents (orchestrator, researcher, planner, implementer) and three
matching skills, wiring up a test-driven research-plan-implement
pipeline.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR introduces a new Claude plugin, junior-dev, under Claude/plugins/junior-dev/, bundling a research → plan → implement workflow into an installable unit with its own agents, skills, and plugin manifest.

Changes:

  • Added a plugin manifest (.claude-plugin/plugin.json) wiring commands and agents for the workflow.
  • Added four workflow agents (orchestrator, researcher, planner, implementer) with model tiering.
  • Added three workflow skills (research/plan/implement) defining the process expectations for each phase.

Reviewed changes

Copilot reviewed 8 out of 8 changed files in this pull request and generated 5 comments.

Show a summary per file
File Description
Claude/plugins/junior-dev/.claude-plugin/plugin.json Declares the plugin and lists command + agent entrypoints.
Claude/plugins/junior-dev/agents/orchestrator/orchestrator.md Defines the phase-gated orchestration flow and sub-agent delegation.
Claude/plugins/junior-dev/agents/researcher/researcher.md Defines a research-only agent that outputs research.md per a schema.
Claude/plugins/junior-dev/agents/planner/planner.md Defines a planning-only agent that converts research into a TDD task plan.
Claude/plugins/junior-dev/agents/implementer/implementer.md Defines an implementation agent that executes the plan via Red/Yellow/Green.
Claude/plugins/junior-dev/skills/research/research.md Skill definition for codebase investigation and impact mapping.
Claude/plugins/junior-dev/skills/plan/plan.md Skill definition for producing a self-contained, test-driven task plan.
Claude/plugins/junior-dev/skills/implement/implement.md Skill definition for executing tasks with strict TDD phase gates.
Comments suppressed due to low confidence (2)

Claude/plugins/junior-dev/agents/researcher/researcher.md:45

  • In the research.md Schema example, the markdown table uses || prefixes (e.g., || File | Role |), which is not valid table syntax and will likely be copied verbatim into outputs. Update the example to standard markdown table formatting (| File | Role |, | --- | --- |, etc.) to avoid generating malformed research files.
## Relevant Files
<Table or bulleted list of every file relevant to the query.>
| File | Role |
|------|------|
| path/to/file.py | <what it does and why it matters here> |

Claude/plugins/junior-dev/agents/implementer/implementer.md:47

  • This constraint conflicts with the implement skill’s rule that says to create missing referenced files (implement skill: “If a task's file references do not exist, create them”). Here the implementer says to stop and report when encountering a missing file. Clarify/align the behavior so the implementer doesn’t receive contradictory instructions (e.g., only stop for missing dependencies not referenced by the plan, but allow creating files explicitly listed in the task’s Files: section).
## Constraints

- Implement exactly what the plan specifies — do not add, remove, or change scope
- Follow all patterns and conventions referenced in each task's context
- If you encounter something the plan did not anticipate (a missing file, an import conflict, an unexpected dependency), stop and report it to the user before continuing — do not improvise a solution

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

description: "Researches a user's query against the codebase — maps current implementation, identifies impacted files, and writes a research.md output file for a downstream implementation agent. Invoke when you need a thorough codebase investigation before any code is written."
model: sonnet
color: yellow
memory: none
description: "Reads a research.md file produced by the researcher agent and writes a test-driven, task-by-task implementation plan to plan.md. Invoke after the researcher agent has completed its output and before any implementation begins."
model: sonnet
color: blue
memory: none
description: "Reads a plan.md file produced by the planner agent and executes every task using strict test-driven development (Red-Yellow-Green). Invoke after the planner has produced its output and the user is ready to begin implementation."
model: haiku
color: green
memory: none
description: "Main entry point for the junior-dev workflow. Takes the user's query and orchestrates the researcher, planner, and implementer agents in sequence — passing outputs between them and confirming with the user at each phase boundary before continuing."
model: sonnet
color: purple
memory: none
Comment on lines +9 to +11
"./skills/research/research.md",
"./skills/plan/plan.md",
"./skills/implement/implement.md"
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