Commit graph

26 commits

Author SHA1 Message Date
Jefferson Rodrigues
31cd06e354
docs(agents): add AGENT_DESIGN.md references to Standards Compliance sections
Added canonical schema reference to 7 implementation/specialist agents that produce Standards Compliance Reports:

- backend-engineer-golang
- backend-engineer-typescript
- devops-engineer
- frontend-bff-engineer-typescript
- frontend-engineer
- qa-analyst
- sre

Each now references docs/AGENT_DESIGN.md as the canonical source for output schema requirements per Content Duplication Prevention rule.

Note: prompt-quality-reviewer already documents its Standards Compliance Report section as 'Not Applicable' since it's an analyst agent.
Generated-by: Claude
AI-Model: claude-sonnet-4-5-20250929
2025-12-11 18:33:59 -03:00
Jefferson Rodrigues
20f867f6ac
docs(devops-engineer): add canonical DevOps standards reference
Added reference to dev-team/docs/standards/devops.md as canonical source to prevent duplication per Content Duplication Prevention rule.

Generated-by: Claude
AI-Model: claude-sonnet-4-5-20250929
2025-12-11 18:16:39 -03:00
Jefferson Rodrigues
2ba19a657f
fix(dev-team): strengthen pressure resistance and anti-rationalization
Applied testing-skills-with-subagents and testing-agents-with-subagents to all dev-team skills and agents. Fixed identified loopholes following RED-GREEN-REFACTOR methodology.

Skills fixed (4):
- dev-cycle: Added Standards Loading, Severity Calibration, Blocker Criteria
- dev-refactor: Added empty PROJECT_RULES.md check and multi-language enforcement
- dev-sre: Added Standards Loading section with WebFetch requirements
- dev-validation: Added 4 missing approval rationalizations

Agents fixed (4):
- devops-engineer: Added WebFetch checkpoint, strengthened required_when logic, added anti-rationalizations
- frontend-bff-engineer-typescript: Added Anti-Rationalization Table to Standards Compliance, strengthened Cannot Be Overridden section
- prompt-quality-reviewer: Added Standards Loading Verification, Improvement Specificity Requirements, Assertiveness Calculation Methodology
- qa-analyst: Added skipped test detection, coverage calculation rules, TDD RED phase clarification

Total: 8 files, 358 insertions(+), 101 deletions(-)
Generated-by: Claude
AI-Model: claude-sonnet-4-5-20250929
2025-12-11 17:50:43 -03:00
Jefferson Rodrigues
5267996631
fix(dev-team): add missing mandatory sections to agents and skill
Add missing CLAUDE.md mandatory sections identified during testing:

- backend-engineer-golang: Add Pressure Resistance table
- devops-engineer: Add Anti-Rationalization Table
- frontend-engineer: Add Anti-Rationalization Table
- using-dev-team skill: Add Blocker Criteria, Anti-Rationalization,
  Cannot Be Overridden sections and strengthen language

Generated-by: Claude
AI-Model: claude-opus-4-5-20251101
2025-12-11 15:44:18 -03:00
Jefferson Rodrigues
4fb263f80f
feat(dev-team): add required_when condition to Standards Compliance for all agents
Add schema-level enforcement for Standards Compliance output when agents
are invoked from dev-refactor skill. The required_when block triggers
when prompt contains "**MODE: ANALYSIS ONLY**" marker.

Updated agents:
- backend-engineer-golang.md (v1.2.2)
- backend-engineer-typescript.md (v1.3.3)
- devops-engineer.md (v1.2.1)
- frontend-bff-engineer-typescript.md (v2.1.2)
- frontend-designer.md (v1.1.2)
- qa-analyst.md (v1.1.2)
- sre.md (v1.2.2)

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2025-12-11 11:31:10 -03:00
Jefferson Rodrigues
8470990be2
feat(dev-team): enforce pattern consistency and anti-rationalization
- Reorganize CLAUDE.md with CRITICAL RULES at top for visibility
- Add Anti-Rationalization Tables documentation (MANDATORY)
- Add Assertive Language Reference for prompt engineering
- Add Agent Modification Verification checklist
- Add Quick Navigation table to CLAUDE.md

- frontend-engineer.md v3.2.0: add 6 missing patterns
  - Blocker Criteria, Severity Calibration, Cannot Be Overridden
  - Pressure Resistance, What If No PROJECT_RULES.md Exists
  - Complete Anti-Rationalization Table

- devops-engineer.md v1.2.0: add Pressure Resistance section

- frontend.md standard: add FORBIDDEN Patterns section
  - TypeScript anti-patterns, Accessibility violations
  - State Management, Security, Fonts, Performance

Generated-by: Claude Code
AI-Model: claude-opus-4-5-20251101
2025-12-11 10:50:15 -03:00
Jefferson Rodrigues
8d6f184888
docs(dev-team): add Standards Compliance cross-reference documentation
Document the conditional Standards Compliance output section requirement across all documentation files and update agent changelogs.

Documentation updates:
- CLAUDE.md: Added comprehensive Standards Compliance section with schema, conditions, and examples
- MANUAL.md: Added note explaining MANDATORY/optional conditions
- README.md: Added blockquote explaining Standards Compliance for dev-team agents
- ARCHITECTURE.md: Added detailed section with schema definition and output format

Hook update:
- session-start.sh: Added Standards Compliance note to context injection

Agent changelog updates (patch version bumps):
- backend-engineer-golang: 1.2.0 → 1.2.1
- backend-engineer-typescript: 1.3.0 → 1.3.1
- devops-engineer: 1.1.0 → 1.1.1
- frontend-bff-engineer-typescript: 2.1.0 → 2.1.1
- frontend-designer: 1.1.0 → 1.1.1
- qa-analyst: 1.1.0 → 1.1.1
- sre: 1.2.0 → 1.2.1

Generated-by: Claude
AI-Model: claude-opus-4-5-20251101
2025-12-11 09:57:48 -03:00
Jefferson Rodrigues
20d9a883c1
refactor(dev-team): remove duplicated standards from agents, use WebFetch
- Refactor all 7 dev-team agents to reference standards via WebFetch
- Remove duplicated Domain Standards sections from agents
- Update golang.md to lib-commons v3 with correct logging pattern:
  - commons/zap for logger initialization (bootstrap/config only)
  - commons/log for Logger interface (services, routes, consumers)
- Add Standards Compliance Output Format section to golang.md
- Add Standards Loading sections to qa-analyst and frontend-engineer agents

Agents now contain only: role definition, output schema, expertise
knowledge, blockers, and WebFetch references to standards files.

Generated-by: Claude
AI-Model: claude-opus-4-5-20251101
2025-12-11 09:08:05 -03:00
Jefferson Rodrigues
7e3e6489aa
refactor(dev-team): remove unimplemented required_when schema field
Removes the required_when field from agent output_schema definitions
as it was not implemented in any orchestrator validation layer. The
conditional requirement for Standards Compliance is already enforced
through prose instructions in each agent's documentation section
'Standards Compliance Report (MANDATORY when invoked from dev-refactor)'.

Updated description to clarify enforcement is via prose instructions.

Generated-by: Claude
AI-Model: claude-opus-4-5-20251101
2025-12-11 08:24:33 -03:00
Jefferson Rodrigues
b899be6f62
feat(dev-team): add Standards Compliance section to agents for dev-refactor
Adds conditional Standards Compliance output section to all dev-team agents. When invoked from dev-refactor skill, agents compare codebase against Lerian/Ring standards (lib-commons for Go, lib-commons-js for TypeScript) and produce compliance reports.

Changes:
- Add Standards Compliance to output_schema with required_when conditional
- Add comparison categories and output format documentation per agent
- Update dev-refactor prompt templates to request compliance reports
- Categories adapted per domain (Go: lib-commons, TS: lib-commons-js, SRE: health/logging/tracing only)

Generated-by: Claude
AI-Model: claude-opus-4-5-20251101
2025-12-10 16:54:58 -03:00
Jefferson Rodrigues
fedb029084
refactor(dev-team): add HARD BLOCK enforcement and remove internal duplications
- Add 'What If No PROJECT_RULES.md Exists?' HARD BLOCK section to all 7 agents
- Add 'What If Non-Compliant?' and 'Cannot Be Overridden' sections to devops, sre, qa agents
- Remove ~230 lines of internal duplications across all agents
- Consolidate Standards Loading references to single source of truth
- Merge redundant Blocker Format templates
- Unify Handling Ambiguous Requirements with cross-references

Generated-by: Claude
AI-Model: claude-opus-4-5-20251101
2025-12-08 11:12:51 -03:00
Jefferson Rodrigues
40ecd8dda0
fix(dev-team): apply test findings - skills and agents improvements
Skills:
- dev-implementation: PROJECT_RULES.md loads locally, no fallback, STOP if missing
- dev-validation: add self-approval prohibition and conditional approval parsing
- dev-review: add user/manager/emergency override rationalizations
- dev-feedback-loop: add repeated feedback detection and escalation
- dev-sre: add mandatory verification checklist (health, metrics, ready, logs)
- dev-testing: update coverage threshold to 85% branch coverage

Agents:
- Standardize PROJECT_RULES.md + Ring Standards as equally important (no hierarchy)
- Add Example Output section to all 7 agents

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2025-12-07 18:38:33 -03:00
Jefferson Rodrigues
e0f30cc8c0
refactor(dev-team): remove frontend-engineer agent and fix state file naming
- Remove frontend-engineer.md agent (consolidated into frontend-bff-engineer-typescript)
- Fix dev-cycle state file inconsistency (cycle-state.json -> current-cycle.json)
- Update all cross-references in 19 files to point to frontend-bff-engineer-typescript
- Update agent count from 8 to 7 in documentation

Generated-by: Claude
AI-Model: claude-opus-4-5-20251101
2025-12-07 11:09:28 -03:00
Jefferson Rodrigues
2ef3a177ff
refactor(dev-team): remove redundant project_rules from input_schema
Agents already load PROJECT_RULES.md via Standards Loading section.
Remove redundant project_rules parameter from input_schema of all agents
and remove {project_rules_content} injection from dev-refactor prompts.

Changes:
- Remove project_rules from 7 agent input_schema files
- Remove {project_rules_content} from dev-refactor Task prompts
- Add notes clarifying agents load standards automatically
- Enhance frontend-bff-engineer-typescript with DDD, Blockers, Severity sections

Generated-by: Claude
AI-Model: claude-opus-4-5-20251101
2025-12-07 10:50:34 -03:00
Jefferson Rodrigues
68e12b304b
fix(dev-team): update WebFetch to explicit tool instruction format
Changed from passive code block format to explicit action instruction:
- Added table with url and prompt parameters
- Clear 'MANDATORY ACTION: You MUST use the WebFetch tool NOW'
- Explicit 'Execute this WebFetch before proceeding' instruction
- Blocker instruction if WebFetch fails

Previous format was just text, not an actionable directive.

Generated-by: Claude
AI-Model: claude-opus-4-5-20251101
2025-12-06 04:57:53 -03:00
Jefferson Rodrigues
1f31623710
fix(dev-team): standardize writing pattern for standards loading across all agents
Consistent format in all agents:
1. `docs/PROJECT_RULES.md` (local project) - If exists, follow it EXACTLY
2. Ring Standards via WebFetch (Step 2 above) - ALWAYS REQUIRED
3. Both are necessary and complementary - no override

**Both Required:** PROJECT_RULES.md (local project) + Ring Standards (via WebFetch)

Generated-by: Claude
AI-Model: claude-opus-4-5-20251101
2025-12-06 04:46:28 -03:00
Jefferson Rodrigues
72063b25ff
fix(dev-team): remove local docs/standards refs, keep only WebFetch for Ring standards
All agents now use:
- PROJECT_RULES.md (local project) for project-specific standards
- Ring Standards via WebFetch from GitHub (always required)

Both are necessary and complementary - no override. Removed all references to local docs/standards/* files that could cause confusion.

Generated-by: Claude
AI-Model: claude-opus-4-5-20251101
2025-12-06 04:45:06 -03:00
Jefferson Rodrigues
73c5cd5222
feat(dev-team): add Standards Loading section to agents with WebFetch URL pattern
- Add mandatory Standards Loading section to 5 agents (golang, typescript, devops, frontend, sre)
- Agents now WebFetch Ring standards from GitHub raw URLs
- Both PROJECT_RULES.md (local) and Ring standards (remote) are HARD GATES
- Fix using-dev-team agent count (9→7), remove non-existent agents
- Add Blocker Criteria section to dev-feedback-loop
- Standardize qa-analyst output_schema to Implementation archetype

Generated-by: Claude
AI-Model: claude-opus-4-5-20251101
2025-12-06 02:53:53 -03:00
Jefferson Rodrigues
d8c2d5a66a
feat(dev-team): add pressure resistance and verification to agents and skills
Enhance all 7 dev-team agents with:
- input_schema and extended output_schema (metrics, error handling, blockers)
- Blocker Criteria - STOP and Report sections
- When Implementation is Not Needed guidance
- Severity Calibration tables
- Project Standards First - MANDATORY sections

Enhance all 9 dev-team skills with:
- verification sections (automated commands, manual checks)
- examples sections with expected behavior
- Pressure Resistance tables with response guidance
- Common Rationalizations - REJECTED tables
- Red Flags - STOP lists

These additions ensure agents and skills resist pressure to skip
quality gates and properly document blockers for orchestrator
escalation.

Generated-by: Claude
AI-Model: claude-opus-4-5-20251101
2025-12-05 21:14:53 -03:00
Jefferson Rodrigues
f3d9d410d6
refactor(dev-team): remove generic backend-engineer and frontend-engineer agents
Remove language-agnostic generic agents in favor of the specialized language-specific variants. This simplifies agent selection by eliminating ambiguity when choosing between generic and specialized versions.

Deleted agents:
- backend-engineer.md (use backend-engineer-golang or backend-engineer-typescript)
- frontend-engineer.md (use frontend-engineer-typescript)

Updated all documentation and cross-references across 19 files to reflect the change from 9 to 7 developer agents.

Generated-by: Claude
AI-Model: claude-opus-4-5-20251101
2025-12-05 16:39:31 -03:00
Jefferson Rodrigues
a3607f2fac
refactor(dev-team): rename STANDARDS.md to PROJECT_RULES.md
Rename project standards file and update all references across 19 files:
- Skills: dev-analysis, dev-implementation, using-dev-team
- Commands: dev-cycle, dev-refactor
- Agents: all 9 developer agents
- Docs: standards/*.md

Generated-by: Claude
AI-Model: claude-opus-4-5-20251101
2025-12-04 12:25:22 -03:00
Jefferson Rodrigues
a6c7996907
docs(agents): clarify project standards references in devops-engineer
Add 'Project Standards Integration' section and clarify that docs/STANDARDS.md and docs/standards/devops.md references are for the user's project, not the ring repository. Aligns with pattern used in backend-engineer-golang.md.

Generated-by: Claude
AI-Model: claude-opus-4-5-20251101
2025-12-04 08:59:07 -03:00
Jefferson Rodrigues
1eef9c74e2
feat(dev-team): add SRE gate and embed standards in agents
Major changes to the development cycle:

- Add Gate 2 (dev-sre) for observability validation (metrics, health checks, logging)
- Update to 6-gate cycle: implementation→devops→SRE→testing→review→validation
- Embed language/domain standards directly into all 10 agents
- Create dev-sre skill with full observability requirements
- Create sre.md standards document
- Rename skills: development-cycle→dev-cycle, dev-devops-setup→dev-devops
- Add dev-analysis skill for codebase analysis against STANDARDS.md
- Add dev-refactor command for standards-based refactoring workflow
- Bump ring-dev-team version to 0.5.0

Generated-by: Claude
AI-Model: claude-opus-4-5-20251101
2025-12-04 00:43:42 -03:00
Jefferson Rodrigues
85df0931a3
feat(dev-team): add language standards with DDD and update agents
Create per-language standards files with DDD patterns:
- golang.md: Go error handling, testing, DDD implementation
- typescript.md: Strict config, branded types, DDD patterns
- python.md: Pydantic, async, DDD with dataclasses
- frontend.md: React patterns, typography, animation
- devops.md: Terraform, Kubernetes, CI/CD, observability

Update all 10 agents with 'Handling Ambiguous Requirements' section
that references standards files before asking questions.

Consolidate development cycle skills by removing merged gates
(dev-analysis, dev-design, dev-import-tasks) into main workflow.

Generated-by: Claude
AI-Model: claude-opus-4-5-20251101
2025-12-03 23:01:47 -03:00
Fred Amaral
cc22894489
feat(agents): define and implement standard agent output schemas
docs(commands): add detailed documentation for core workflows
fix(scripts): improve argument and file path handling in shell
refactor(hooks): use jq for robust JSON escaping in session-start hook
fix(docs): correct gate numbering in pre-dev feature documentation
2025-11-26 17:42:48 -03:00
Fred Amaral
4ceda3ee39
refactor(plugins): rename core plugins to team-based structure
feat(dev-team): expand developer agents to 10 with language specialists
feat(ralph-wiggum): add plugin for iterative development loops via Stop hook
docs: overhaul all documentation for new plugin organization
fix(hooks): ignore symlinks in claude-md-reminder script
chore(deps): pin PyYAML version and update plugin installs in hooks
2025-11-26 15:05:24 -03:00
Renamed from developers/agents/devops-engineer.md (Browse further)