Commit graph

62 commits

Author SHA1 Message Date
Jefferson Rodrigues
b8dbc9bc3b
feat(agents): add Standards Verification to remaining dev-team agents
Add required 'Standards Verification' as FIRST output section to:
- qa-analyst (v1.3.2)
- devops-engineer (v1.3.3)
- sre (v1.4.2)
- frontend-engineer (v3.2.6)
- frontend-designer (v1.2.3)

Agents MUST output table showing PROJECT_RULES.md and Ring Standards status
before any implementation/validation work.

X-Lerian-Ref: 0x1
2026-01-13 11:13:39 -03:00
Jefferson Rodrigues
12f23dd5ad
fix: add MUST enforcement word to WebFetch instructions in all agents
Apply lexical salience guideline to:
- backend-engineer-typescript.md
- frontend-engineer.md
- backend-engineer-golang.md
- devops-engineer.md
- frontend-designer.md

Generated-by: Claude
AI-Model: claude-sonnet-4-20250514
2026-01-06 17:09:05 -03:00
Jefferson Rodrigues
8c9081a393
docs: add semantic tags to Batch 5 specialist agents
Add semantic block tags to:
- devops-engineer.md: fetch_required, forbidden, block_condition, cannot_skip
- sre.md: cannot_skip, forbidden, fetch_required, block_condition
- qa-analyst.md: fetch_required, forbidden
- frontend-designer.md: fetch_required, forbidden, block_condition
- prompt-quality-reviewer.md: fetch_required, block_condition, cannot_skip

Tags added per semantic-tags-refactor.md plan.

Generated-by: Claude
AI-Model: claude-sonnet-4-20250514
2026-01-06 16:22:32 -03:00
Jefferson Rodrigues
efcadfb761
docs: apply strategic spacing to dev-team skills and agents
Apply the attention reset pattern with horizontal separators (---) between
major sections in all dev-team plugin files:

Skills (6 files):
- dev-implementation: Added separator before Anti-Rationalization
- dev-devops: Added separator before Anti-Rationalization
- dev-sre: Added separators before Blocker Criteria, Cannot Be Overridden, Anti-Rationalization
- dev-testing: Added separator before Anti-Rationalization
- dev-validation: Added separators before Severity Calibration, Common Rationalizations, Ambiguous Response, Awaiting Approval, Prerequisites
- dev-feedback-loop: Added separators before Self-Preservation Bias, Repeated Feedback, Threshold Alerts, Assertiveness Score

Agents (8 files):
- backend-engineer-golang: Added separators before Blocker Criteria, Output Rule
- backend-engineer-typescript: Added separator before Blocker Criteria
- devops-engineer: Added separators before Blocker Criteria, Anti-Rationalization
- frontend-bff-engineer-typescript: Added separator before Blocker Criteria
- frontend-engineer: Added separator before Blocker Criteria
- frontend-designer: Added separator before Blocker Criteria
- qa-analyst: Added separator before Blocker Criteria
- sre: Added separator before Blocker Criteria

This follows the Strategic Spacing guideline added to CLAUDE.md for improved
AI attention management between critical rule sections.

Generated-by: Claude
AI-Model: claude-opus-4-5-20251101
2026-01-06 14:39:55 -03:00
Jefferson Rodrigues
789a9ae746
refactor: normalize capitalization and convert relative URLs to absolute
Generated-by: Claude
AI-Model: claude-sonnet-4-20250514
2026-01-06 13:09:01 -03:00
Jefferson Rodrigues
87a7209a0c
refactor: normalize capitalization and use absolute URLs in templates
Generated-by: Claude
AI-Model: claude-sonnet-4-20250514
2026-01-06 12:55:48 -03:00
Jefferson Rodrigues
5c289a92db
refactor: apply lexical salience fixes and consistency improvements
- Fix FOUR-FILE UPDATE RULE references in all 5 standards files
- Replace 'any LAYER' with 'any layer' in sre.md diagrams
- Concise rewording in dev-cycle and dev-refactor skills
- Add Anti-Duplication Check to template-tdd-prompts.md
- Fix sentence capitalization in standards-coverage-table.md
- Standardize section header casing in agent files
- Replace 'fix' with 'resolve' in sre.md for formal tone

Generated-by: Claude
AI-Model: claude-sonnet-4-20250514
2026-01-06 12:22:25 -03:00
Jefferson Rodrigues
0fa3a43b1b
refactor: apply lexical salience guidelines across dev-team plugin
- Remove diluted CAPS words (ALL, ANY, ONLY, EACH, EVERY, NOT, NO, etc.)
- Preserve enforcement words (MUST, STOP, HARD GATE, FAIL, PASS, etc.)
- Add Lexical Salience Guidelines section to CLAUDE.md
- Rewrite docs/PROMPT_ENGINEERING.md with new approach
- Create docs/plans/lexical-salience-refactor.md plan
- Update 35 dev-team files (skills, agents, standards, commands)

Principle: Selective emphasis creates focus - fewer CAPS words
at sentence beginnings produce higher AI attention on critical
instructions.

Generated-by: Claude
AI-Model: claude-sonnet-4-20250514
2026-01-06 11:35:39 -03:00
Jefferson Rodrigues
b6d5b4953e
refactor(dev-team): remove inline section tables, reference coverage table
Agents now reference standards-coverage-table.md instead of duplicating section lists inline. This prevents drift between agents and the canonical coverage table.

Also strengthens CodeRabbit execution rules in requesting-code-review skill - MANDATORY if installed, optional to install.

X-Lerian-Ref: 0x1
2026-01-06 10:46:33 -03:00
Jefferson Rodrigues
050f8a03c7
fix(dev-team): prevent agents from hallucinating requirements not in standards
- Add standards-boundary-enforcement.md shared pattern
- Update all 8 dev-team agents with Standards Boundary Enforcement section
- Strengthen ORCHESTRATOR principle with explicit tool prohibition table
- Add recovery process for ORCHESTRATOR violations
- Add anti-rationalization rules for standards boundary

Agents must now:
1. WebFetch standards file first
2. Check ONLY requirements explicitly listed in standards
3. Verify before flagging - if not in WebFetch result, do NOT flag
4. Never directly edit source code (dispatch specialists instead)

Generated-by: Claude
AI-Model: claude-sonnet-4-20250514
2026-01-05 16:16:09 -03:00
Fred Amaral
c589bc8ca1
feat(agents): introduce system-wide AI slop detection and prevention
AI agents can generate plausible but flawed code ("AI slop") that
includes hallucinated dependencies, scope creep, and context-unaware
implementations. This is a primary source of bugs and security risks.

To address this, introduce a system-wide framework for detecting and
preventing AI slop, centered around a new shared skill document:
`ai-slop-detection.md`.

This framework is integrated across the agent ecosystem:
- Specialist agents (engineers, DevOps) now perform a mandatory
 pre-submission self-check to catch their own slop before review.
- Reviewer agents (code, security, business) use new mandatory
 checklists to enforce quality gates against slop from other agents.
- Validation agents (QA, SRE) must verify command outputs to prevent
 reporting hallucinated metrics or test results.

This provides a defense-in-depth strategy against common AI failure
modes, improving code quality and mitigating supply-chain attack
vectors like "slopsquatting."
2025-12-28 10:32:42 -03:00
Jefferson Rodrigues
3173949e88
refactor(dev-team): replace inline patterns with standards references via WebFetch
- Remove hardcoded FORBIDDEN patterns from all 8 dev-team agents
- Add mandatory Standards Reference tables with file/section/anchor
- Require WebFetch to load patterns dynamically (proves agent reads standards)
- Add CRITICAL instruction: Do NOT hardcode patterns, extract from WebFetch
- Create STANDARDS-INDEXING-PLAN.md documenting the refactoring approach

Agents refactored:
- backend-engineer-golang.md: logging, HTTP, telemetry, bootstrap patterns
- backend-engineer-typescript.md: type safety, DI, error handling patterns
- frontend-bff-engineer-typescript.md: type safety, DI patterns
- frontend-engineer.md: forbidden patterns, accessibility patterns
- frontend-designer.md: forbidden patterns, accessibility, styling
- devops-engineer.md: security, container patterns
- sre.md: logging validation patterns (language-specific)
- qa-analyst.md: test patterns (language-specific)

X-Lerian-Ref: 0x1
2025-12-23 11:09:51 -03:00
Jefferson Rodrigues
91c00a82f4
feat(agents): add FORBIDDEN Patterns Check HARD GATE to all dev-team agents
Each agent must now LIST FORBIDDEN patterns before any work:
- backend-engineer-typescript: any, @ts-ignore, console.log, untyped params
- frontend-bff-engineer-typescript: any, @ts-ignore, console.log, no DI
- frontend-engineer: any, inline styles, console.log, missing a11y
- frontend-designer: generic fonts, missing dark mode, missing a11y
- devops-engineer: hardcoded secrets, :latest tag, root user, no health checks
- qa-analyst: assertion-less tests, skipped tests, shared state
- sre: fmt.Println, log.Printf, console.log (validation acknowledgment)

Agents must prove they read standards by listing patterns in output.
Missing acknowledgment = implementation/specification/test INVALID.

X-Lerian-Ref: 0x1
2025-12-23 03:24:05 -03:00
Jefferson Rodrigues
f4ef03b244
refactor: remove ring-{plugin}: prefix from agent/skill/command names
Simplify naming convention by removing fully qualified prefixes from all components. Names now use simple format (e.g., code-reviewer instead of ring-default:code-reviewer).

X-Lerian-Ref: 0x1
2025-12-16 01:50:31 -03:00
Jefferson Rodrigues
4cd6651cac
fix: use fully qualified agent names (ring-{plugin}:{agent})
Update all agent references to use the ring-{plugin}:{agent-name} format instead of bare agent names. This ensures consistent naming across all plugins and prevents ambiguity in multi-plugin environments.

X-Lerian-Ref: 0x1
2025-12-15 22:13:38 -03:00
Jefferson Rodrigues
259db01a32
fix: add fully qualified ring-{plugin}:{component} prefixes to all refs
Generated-by: Claude
AI-Model: claude-opus-4-5-20251101
2025-12-15 21:22:06 -03:00
Jefferson Rodrigues
9b4fd3a5f4
fix: update all remaining component references to ring-{plugin}:{name} format
Comprehensive update of all agent, skill, and command references throughout
the repository to use fully qualified names:

- Agent refs: `agent-name` → `ring-{plugin}:agent-name`
- Skill refs: `skill-name` → `ring-{plugin}:skill-name`
- Command refs: `/command` → `/ring-{plugin}:command`

Files updated include:
- All agent files in */agents/
- All skill files in */skills/
- All command files in */commands/
- Documentation files (README, CLAUDE.md, ARCHITECTURE.md, WORKFLOWS.md)
- Shared patterns and standards files

This ensures consistency between documentation and implementation,
enabling unambiguous component resolution in multi-plugin environments.

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

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2025-12-15 20:26:43 -03:00
Jefferson Rodrigues
bd9bc7d2ad
fix: update all internal references to use ring-{plugin}:{name} format
- Agent invocation examples in 44 agent files
- Subagent_type references in skill files
- Skill tool references across all plugins
- Command references in pmo-team, ops-team, tw-team commands
- docs/platforms/claude-code.md examples
- dev-team/skills/shared-patterns/shared-orchestrator-principle.md
2025-12-15 20:14:32 -03:00
Jefferson Rodrigues
5473e2a41b
refactor: standardize naming to ring-{plugin}:{component} format
Update all agents, skills, and commands across 9 plugins to use fully qualified names in YAML frontmatter. This enables unambiguous component identification in multi-plugin environments.

Changes:

- 42 agents: name field updated to ring-{plugin}:{agent-name}

- 87 skills: name field updated to ring-{plugin}:{skill-name}

- 27 commands: name field updated (added frontmatter where missing)

- CLAUDE.md: Fixed contradictory examples in naming conventions

- ARCHITECTURE.md: Updated invocation examples throughout

X-Lerian-Ref: 0x1
2025-12-15 19:52:14 -03:00
Jefferson Rodrigues
228a79cb20
refactor: rename shared-patterns files with semantic prefixes
- Rename execution-report.md to output-execution-report.md
- Rename anti-rationalization.md to shared-anti-rationalization.md
- Rename orchestrator-principle.md to shared-orchestrator-principle.md
- Rename pressure-resistance.md to shared-pressure-resistance.md
- Rename red-flags.md to shared-red-flags.md
- Rename tdd-prompt-templates.md to template-tdd-prompts.md
- Update all references across skills, agents, and documentation

Co-authored-by: factory-droid[bot] <138933559+factory-droid[bot]@users.noreply.github.com>
2025-12-15 19:22:07 -03:00
Fred Amaral
03e6136464
feat(agents): add model self-verification to prevent incorrect usage
docs(standards): mandate explicit model parameter for specialized agents
feat(reviewers): add guidance for skipping reviews on trivial changes
refactor(docs): simplify shared pattern files for better reusability
fix(security): add SSRF to blocker criteria and OWASP version check
fix(docs): align heading levels and table formats for consistency
2025-12-14 00:05:33 -03:00
Jefferson Rodrigues
9976b3fb15
refactor(dev-team): remove CI/CD references, make DDD mandatory
- Remove all CI/CD references from skills and agents

- Make DDD patterns MANDATORY for all services (Go, TypeScript, BFF)

- Update standards and agent files with mandatory language

Generated-by: Claude
AI-Model: claude-opus-4-5-20251101
2025-12-13 22:55:27 -03:00
Jefferson Rodrigues
8b1b9dd034
refactor(shared-patterns): consolidate 4 files into 2 combined files
Combined files:
- anti-rationalization-agents.md + anti-rationalization-skills.md → anti-rationalization.md
- standards-loading.md + project-rules-handling.md → standards-workflow.md

Updated references in:
- CLAUDE.md (Shared Patterns table)
- 8 agent files
- 4 skill files

Benefits:
- Reduced file count from 11 to 9 in shared-patterns/
- Single source for anti-rationalization patterns
- Single source for standards workflow (loading + handling)
- Easier maintenance and discovery

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

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2025-12-13 20:50:33 -03:00
Jefferson Rodrigues
44e2a77f9d
refactor(agents): extract PROJECT_RULES.md Handling to shared-patterns
- Created dev-team/skills/shared-patterns/project-rules-handling.md
- Updated 8 agents to reference shared pattern:
  - backend-engineer-golang.md
  - backend-engineer-typescript.md
  - frontend-engineer.md
  - frontend-designer.md
  - frontend-bff-engineer-typescript.md
  - devops-engineer.md
  - sre.md
  - qa-analyst.md
- Each agent retains domain-specific non-compliant signs
- Reduced each Handling Ambiguous Requirements section by ~75-85%

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

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2025-12-13 20:50:33 -03:00
Jefferson Rodrigues
f893705d33
refactor(agents): extract Standards Loading Pattern to shared-patterns
- Created dev-team/skills/shared-patterns/standards-loading.md
- Updated 9 agents to reference shared pattern:
  - backend-engineer-golang.md
  - backend-engineer-typescript.md
  - frontend-engineer.md
  - frontend-designer.md
  - frontend-bff-engineer-typescript.md
  - devops-engineer.md
  - sre.md
  - qa-analyst.md
  - prompt-quality-reviewer.md
- Each agent retains only domain-specific config (WebFetch URL, prompt)
- Reduced each Standards Loading section from ~30 lines to ~15 lines

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

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2025-12-13 20:50:33 -03:00
Jefferson Rodrigues
60bcb7dd14
refactor(agents): extract Standards Compliance Mode Detection to shared-patterns
- Created dev-team/skills/shared-patterns/standards-compliance-detection.md
- Updated 8 agents to reference shared pattern instead of duplicating:
  - backend-engineer-golang.md
  - backend-engineer-typescript.md
  - frontend-engineer.md
  - devops-engineer.md
  - sre.md
  - qa-analyst.md
  - frontend-bff-engineer-typescript.md
  - frontend-designer.md
- Each agent retains only agent-specific config (WebFetch URL, example sections)
- Estimated ~1,040 lines of duplication removed

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

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2025-12-13 20:50:32 -03:00
Jefferson Rodrigues
6728dfb76a
refactor(shared-patterns): standardize anti-rationalization file names
Rename files to group related content alphabetically:
- agent-anti-rationalization.md -> anti-rationalization-agents.md
- skills-anti-rationalization.md -> anti-rationalization-skills.md

Update all 14 files referencing these shared patterns.

Generated-by: Claude
AI-Model: claude-opus-4-5-20251101
2025-12-13 19:48:18 -03:00
Jefferson Rodrigues
e170cd9293
refactor(dev-team): streamline agent responsibilities and remove validation scope
Agents and skills updated to focus on core responsibilities:

- DevOps: Focus on containerization (Dockerfile, docker-compose), Helm, IaC

- SRE: Focus on logging, tracing, health checks validation only

- Removed CI/CD, Kubernetes orchestration, RBAC from DevOps agent scope

- Removed SLI/SLO, Alerting, Metrics validation from SRE agent scope

- Updated backend engineers, dev-cycle, using-dev-team references

Standards files (devops.md, sre.md) unchanged - kept as reference docs.

Generated-by: Claude
AI-Model: claude-opus-4-5-20251101
2025-12-13 18:51:25 -03:00
Jefferson Rodrigues
a6726292f7
refactor(dev-team): extract standards coverage table to shared-patterns
- Create standards-coverage-table.md with mandatory table format, status legend, anti-rationalization rules, and agent→standards section index

- Update all dev-team agents to reference shared pattern instead of duplicating instructions

- Add explicit TDD RED/GREEN sub-phases (0.1, 0.2) to dev-cycle Gate 0

- Enhance dev-implementation with detailed TDD phase tracking and state persistence

- Add Standards-Agent Synchronization rule (#5) to CLAUDE.md critical rules

Generated-by: Claude
AI-Model: claude-opus-4-5-20251101
2025-12-13 17:30:38 -03:00
Jefferson Rodrigues
38432d6ae4
refactor(dev-team): extract duplicated content to shared-patterns
Create shared-patterns directory with reusable content:
- pressure-resistance.md: Universal pressure scenarios for all gates
- anti-rationalization.md: Universal anti-rationalizations for skills
- agent-anti-rationalization.md: Agent-specific anti-rationalizations
- execution-report.md: Standard execution report format

Update 6 skills and 8 agents to reference shared patterns instead of
duplicating content. Add Shared Patterns Rule to CLAUDE.md enforcing
extraction of duplicated content to canonical locations.

Generated-by: Claude
AI-Model: claude-opus-4-5-20251101
2025-12-13 16:10:27 -03:00
Jefferson Rodrigues
f5f890c2f6
fix(dev-team): require agents to compare EVERY section from standards file
Added mandatory section comparison process: agents must parse ALL sections from WebFetch result and compare each one with codebase-report.md. No section can be skipped - if not applicable, must report as N/A with reason.

Generated-by: Claude
AI-Model: claude-opus-4-5-20251101
2025-12-13 15:32:39 -03:00
Jefferson Rodrigues
0b808c5cee
fix(dev-team): add mandatory WebFetch standards quoting to agent findings output
Updated all 8 dev-team agents to require quoting from WebFetch results when reporting non-compliant findings. Agents must now include actual code/patterns from both codebase-report.md and the fetched standards file in their findings output.

Generated-by: Claude
AI-Model: claude-opus-4-5-20251101
2025-12-13 14:29:56 -03:00
Jefferson Rodrigues
860b13ba8f
feat(dev-team): enhance Standards Compliance mode detection with robust pattern matching
- Add multi-pattern detection (case-insensitive, partial markers, explicit requests)

- Add Python pseudocode showing detection logic for all 8 dev-team agents

- Add anti-rationalization tables for mode detection

- Add fail-safe behavior: when uncertain, include Standards Compliance section

Generated-by: Claude
AI-Model: claude-opus-4-5-20251101
2025-12-13 14:12:37 -03:00
Jefferson Rodrigues
751eab0059
refactor(dev-team): remove endpoint requirements and add auto-triggered standards compliance
Remove /health, /ready, /metrics endpoint requirements from SRE validation:
- Gate 2 now requires structured logging and tracing only
- Endpoints removed from skills, agents, and standards docs
- Reduces infrastructure coupling for simpler services

Add AUTO-TRIGGERED Standards Compliance to 8 agents:
- Detects MODE: ANALYSIS ONLY in dispatch prompt
- Auto-triggers WebFetch of Ring standards + comparison table
- HARD GATE enforcement when triggered
- Optional for direct implementation tasks

Generated-by: Claude
AI-Model: claude-opus-4-5-20251101
2025-12-12 04:31:31 -03:00
Jefferson Rodrigues
d981a6392d
fix(dev-team): correct URLs and naming conventions in agents and skills
Fix multiple linting and convention issues:
- prompt-quality-reviewer: wrap bare URL in markdown link, add blank line before table
- devops-engineer: fix canonical URL path to include dev-team/ prefix, rename section to standard 'When Implementation is Not Needed'
- qa-analyst: use fully qualified skill name ring-dev-team:dev-refactor, fix coverage recalculation commands for Jest and pytest
- dev-review: replace raw GitHub URLs with repository-relative paths for internal references

All changes improve consistency with project conventions and fix incorrect command patterns.

Generated-by: Claude
AI-Model: claude-sonnet-4-5-20250929
2025-12-11 18:52:14 -03:00
Jefferson Rodrigues
bae209616d
fix(dev-team): convert all canonical references to GitHub raw URLs
Converted all canonical references from relative paths to GitHub raw URLs for installation-agnostic access:

Changed pattern:
- Before: [CLAUDE.md](../../../CLAUDE.md)
- After: [CLAUDE.md](https://raw.githubusercontent.com/LerianStudio/ring/main/CLAUDE.md)

Files updated (18 total):
- All 10 dev-team skills
- All 8 dev-team agents with Standards Compliance Reports

Benefits:
- Works regardless of Ring installation location
- Consistent with WebFetch pattern already used in Standards Loading
- No broken links if directory structure changes
- Agent prompts can always access canonical sources

Generated-by: Claude
AI-Model: claude-sonnet-4-5-20250929
2025-12-11 18:37:45 -03:00
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