Commit graph

30 commits

Author SHA1 Message Date
Jefferson Rodrigues
675a4e3029
feat(standards): add TOC to all standards files and improve skill execution
- Add Table of Contents to devops.md, frontend.md, golang.md, sre.md, typescript.md
- Update CLAUDE.md with Four-File Update Rule and TOC maintenance guidelines
- Add checklist for adding/removing sections in standards files
- Improve dev-refactor skill to use Skill tool for dev-cycle handoff
- Add anti-rationalization patterns for gate execution shortcuts
- Add Execution Report sections to dev-cycle, dev-feedback-loop, dev-refactor
- Extract gap tracking rationalizations to shared-anti-rationalization.md

Generated-by: Claude
AI-Model: claude-opus-4-5-20251101
2025-12-17 12:47:03 -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
141e102b73
fix: add fully qualified prefixes to skill refs across all plugins
Update sequence and related fields in SKILL.md files across default, dev-team, finance-team, ops-team, pmo-team, and tw-team plugins to use ring-{plugin}:{component} naming format.

X-Lerian-Ref: 0x1
2025-12-15 21:12:54 -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
Jefferson Rodrigues
394277f5d0
refactor(dev-team): deduplicate skills by consolidating to shared-patterns
- Enhanced pressure-resistance.md with 10 universal pressure types
- Enhanced anti-rationalization.md with TDD/Review/Validation/Dispatch sections
- Created red-flags.md with universal STOP indicators
- Updated 9 skills to reference shared-patterns instead of duplicating
- Net reduction: 103 lines (402 removed, 299 added)

Generated-by: Claude
AI-Model: claude-sonnet-4-20250514
2025-12-15 02:06:53 -03:00
Jefferson Rodrigues
57fc822538
refactor(dev-team): enhance enforcement and documentation sync
CLAUDE.md:
- Add CLAUDE.md ↔ AGENTS.md symlink synchronization section
- Document rules for maintaining symlink integrity
- Update quick navigation and checklist

dev-feedback-loop/SKILL.md:
- Add Step 0: TodoWrite tracking (MANDATORY FIRST ACTION)
- Add Step 7: Complete TodoWrite tracking (MANDATORY FINAL ACTION)
- Renumber steps 4-5 to 5-6

dev-refactor/SKILL.md:
- Add FORBIDDEN/REQUIRED actions for Steps 4.1 and 5
- Add anti-rationalization tables for finding extraction
- Add HARD GATE verification for issue mapping

Generated-by: Factory
Co-authored-by: factory-droid[bot] <138933559+factory-droid[bot]@users.noreply.github.com>
2025-12-14 15:55:59 -03:00
Jefferson Rodrigues
db2965866d
refactor(dev-team): relocate state path and enhance cycle enforcement
- Change state file path from .ring/dev-team/ to docs/refactor/
- Add mandatory feedback-loop skill invocation with HARD GATES
- Add Step 4.5 to dev-refactor for saving individual agent reports
- Add anti-rationalization tables for feedback loop execution
- Remove outdated testing summary document

Generated-by: Claude
AI-Model: claude-opus-4-5-20251101
2025-12-14 02:28:45 -03:00
Jefferson Rodrigues
89c597fa50
fix(dev-team): close pressure resistance gaps in 3 skills
Applied RED-GREEN-REFACTOR testing methodology to all 19 dev-team components. Fixed identified gaps in 3 skills:

- dev-cycle: Added Demo, Fatigue, Economic pressure scenarios to Pressure Resistance table, strengthened anti-rationalization format
- dev-validation: Added 4 self-approval rationalizations and Manager Override pressure scenario
- dev-feedback-loop: Strengthened Step 1 with MANDATORY execution clause for all tasks including 100% scores

Testing revealed 100% agent compliance (9/9 perfect) and improved skills from 70% to 100% pass rate. Post-fix system health: 97.2/100 (exceptional quality).

Testing artifacts: docs/testing/dev-team-testing-*-2025-12-11.md

Generated-by: Claude
AI-Model: claude-sonnet-4-5-20250929
2025-12-11 19:53:28 -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
baacfe79ef
docs(dev-team): add canonical references to all remaining skills
Added canonical references to 6 skills per Content Duplication Prevention rule:

- dev-devops: References CLAUDE.md and devops.md standards
- dev-feedback-loop: References CLAUDE.md for validation/gate requirements
- dev-implementation: References CLAUDE.md and test-driven-development skill
- dev-review: References CLAUDE.md and requesting-code-review skill
- dev-testing: References CLAUDE.md and test-driven-development skill
- using-dev-team: References CLAUDE.md and using-ring skill

All 10 dev-team skills now have canonical references pointing to single sources of truth.

Generated-by: Claude
AI-Model: claude-sonnet-4-5-20250929
2025-12-11 18:22:20 -03:00
Fred Amaral
b544573ddd
Merge branch 'main' into feature/token-counting 2025-12-09 10:30:09 -03:00
Fred Amaral
c665ff2ac4
refactor(docs): make skill documentation concise and scannable
This commit overhauls numerous skill files to prioritize information
density and improve readability for both humans and AI agents.

The main changes involve replacing verbose sections, such as Graphviz
diagrams and long descriptive paragraphs, with more structured and
compact formats like Markdown tables and simple text flows. This makes
the documents easier to parse and quicker to understand at a glance.

This refactoring aims to reduce the token count and cognitive load
required to process each skill, ensuring that the core patterns and
rules are immediately accessible.
2025-12-08 20:25:43 -03:00
Jefferson Rodrigues
0debc93ee3
feat(dev-team): add prompt quality feedback system for agents
Add agent output collection and prompt quality analysis to the dev-cycle:

- Store agent outputs in state (agent_outputs) at each gate for later analysis
- Add Step 3 to dev-feedback-loop for prompt quality analysis
- Create prompt-quality-reviewer agent to analyze outputs against agent definitions
- Calculate prompt quality scores based on MUST rules, output schema, and decision correctness
- Output feedback to docs/feedbacks/cycle-{date}/{agent}.md (one file per agent, accumulating tasks)

The feedback system enables continuous improvement of agent prompts by:
- Identifying rule violations with evidence
- Tracking patterns across multiple executions
- Generating specific, actionable prompt improvements

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

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2025-12-08 17:50:46 -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
f61d9b3282
fix(dev-team): add pressure resistance sections to all skills and agents
Add comprehensive pressure resistance sections to all 10 dev-team skills and 2 frontend agents based on subagent testing results. Changes include:

Skills (10):
- dev-cycle: demo pressure, incremental compromise prevention
- dev-implementation: DELETE definition clarity, reference loophole closure
- dev-testing: coverage threshold governance (Ring min can't be lowered)
- dev-review: MEDIUM severity explicit protocol
- dev-sre: feature-complete redefinition prevention
- dev-devops: demo pressure handling
- dev-feedback-loop: self-preservation bias prevention
- dev-validation: ambiguous response handling table
- dev-refactor: analysis-to-action pipeline requirement
- using-dev-team: self-sufficiency bias check

Agents (2):
- frontend-designer: scope boundary enforcement, code vs spec
- frontend-bff-engineer-typescript: non-compliant codebase handling

All additions follow the standard pattern: Pressure Resistance table, Common Rationalizations - REJECTED table, Red Flags - STOP list.

Generated-by: Claude
AI-Model: claude-opus-4-5-20251101
2025-12-07 17:38:51 -03:00
Jefferson Rodrigues
c85985de23
fix(dev-team): remove loopholes that allowed AI to skip mandatory gates
Hardens dev-cycle, dev-review, dev-feedback-loop, and dev-sre skills by:
- Removing quantitative exceptions (<5 lines, <20 lines) from skip_when
- Adding NOT_skip_when sections with explicit rationalization rejections
- Expanding Common Rationalizations tables with new anti-patterns
- Adding Red Flags to catch self-exemption attempts

All gates now enforce absolute rules: AI doesn't negotiate, no exceptions.

Generated-by: Claude
AI-Model: claude-opus-4-5-20251101
2025-12-06 03:26:08 -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
ca8b9322f7
fix(dev-team): align assertiveness calculation with gate metrics example
Step 1 shows Gate 3 with 2 iterations (1 extra), so Step 2 calculation
should show 1 extra iteration = -10 penalty, resulting in score 90/100.

Generated-by: Claude
AI-Model: claude-opus-4-5-20251101
2025-12-04 10:02:41 -03:00
Jefferson Rodrigues
d47ec23453
fix(dev-team): qualify skill references in prevention measures
Generated-by: Claude
AI-Model: claude-opus-4-5-20251101
2025-12-04 09:58:37 -03:00
Jefferson Rodrigues
ef09c02e07
fix(dev-team): remove unused references and fix dispatch format
dev-feedback-loop: Replace unused skill references (root-cause-tracing,
codify-solution) with actual complementary skills (dev-cycle, dev-validation).
Add language identifier to formula code block.

dev-analysis: Fix agent dispatch format to use proper YAML structure with
explicit Task tool calls for parallel agent dispatch. Update AskUserQuestion
to match Claude Code's standard format with questions array and options.

Generated-by: Claude
AI-Model: claude-opus-4-5-20251101
2025-12-04 09:50:56 -03:00
Jefferson Rodrigues
61cbcc3551
fix(dev-team): align root cause analysis with Gate 3 (Testing) context
Update root cause analysis example to use testing-related failures:
- Coverage gaps, missing edge case tests, fixture issues
- Root cause: TDD RED phase skipped

Update corrective actions and prevention measures to reference
correct gate numbers and skill names.

Generated-by: Claude
2025-12-04 09:30:04 -03:00
Jefferson Rodrigues
600442af53
fix(dev-team): qualify skill names in feedback-loop examples
Update skill references in improvement suggestions example:
- dev-testing → ring-dev-team:dev-testing
- dev-review → ring-dev-team:dev-review

Generated-by: Claude
2025-12-04 09:21:00 -03:00
Jefferson Rodrigues
a3fdd22bc8
fix(dev-team): correct gate number in blocked execution example
Update GATE BLOCKED example in dev-feedback-loop/SKILL.md to use
"Gate 4 (Review)" instead of "Gate 3 (Review)" to match the canonical
6-gate sequence: Gate 0 (Implementation), Gate 1 (DevOps), Gate 2 (SRE),
Gate 3 (Testing), Gate 4 (Review), Gate 5 (Validation).

Generated-by: Claude
2025-12-04 09:06:46 -03:00
Jefferson Rodrigues
53f79786fe
fix(dev-team): align feedback-loop gate structure with dev-cycle
Updated gate tables and references to use canonical 6-gate structure:
- Gate 0: Implementation
- Gate 1: DevOps
- Gate 2: SRE (was missing)
- Gate 3: Testing
- Gate 4: Review
- Gate 5: Validation

Removed references to non-existent "Planning" and "Design" gates.
Both example metrics table and aggregate report now use consistent
gate numbering (Gate 0-5) matching dev-cycle workflow.

Generated-by: Claude
Co-Authored-By: Claude <noreply@anthropic.com>
2025-12-04 08:59:09 -03:00
Jefferson Rodrigues
988dee73ac
fix(dev-team): qualify all skill references in frontmatter
Updated sequence and related fields in all dev-team skill YAML
frontmatter to use fully qualified names:
- ring-dev-team:skill-name for dev-team skills
- ring-default:skill-name for default plugin skills

Ensures consistent invocation names across the plugin ecosystem
per naming convention guidelines.

Generated-by: Claude
Co-Authored-By: Claude <noreply@anthropic.com>
2025-12-04 08:59:08 -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
Jefferson Rodrigues
f714aff480
feat(dev-team): add 8-gate development cycle and DDD/TDD knowledge
Introduces a comprehensive development cycle orchestrator with 8 quality gates:
- Gate 0: Import tasks from markdown
- Gate 1: Analysis with codebase-explorer (agent recommendation)
- Gate 2: Technical design
- Gate 3: Implementation with TDD
- Gate 4: DevOps setup
- Gate 5: Unit testing
- Gate 6: Parallel code review (3 reviewers)
- Gate 7: Validation

Adds DDD and TDD knowledge to all backend agents (concepts only, no code).
Implementation patterns are referenced from docs/STANDARDS.md.

New skills: development-cycle, dev-analysis, dev-design, dev-implementation,
dev-devops-setup, dev-testing, dev-review, dev-validation, dev-import-tasks,
dev-feedback-loop, dev-writing-code (agent selection guide)

New commands: /dev-cycle, /dev-status, /dev-report, /dev-cancel

Generated-by: Claude
AI-Model: claude-opus-4-5-20251101
2025-12-03 16:05:47 -03:00