Commit graph

42 commits

Author SHA1 Message Date
Fred Amaral
7fd01e41f7
feat(workflows): expand code review and dev-cycle with advanced testing
The parallel code review process expands from 3 to 5 reviewers to
enhance code quality. This introduces `ring:test-reviewer` and
`ring:nil-safety-reviewer` to provide deeper analysis of test coverage
and null safety patterns, improving overall reliability.

The `dev-cycle` workflow is upgraded from a 6-gate to a 10-gate process,
incorporating a sophisticated suite of automated testing gates:
- Unit Testing (Gate 3)
- Fuzz Testing (Gate 4)
- Property-based Testing (Gate 5)
- Integration Testing (Gate 6)
- Chaos Testing (Gate 7)

This change establishes a much higher standard for testing and ensures
features are more resilient and production-ready.

Finally, new agents and commands are added to the PMO and Product plugins
to support delivery tracking, design validation, and reporting, further
extending the system's capabilities across the development lifecycle.
All documentation is updated to reflect these enhancements.
2026-02-09 21:05:41 -03:00
Fred Amaral
a22f7fc3f7
Revert "docs: update prose and examples to use ring- format"
This reverts commit b69a16c405.
2026-02-09 09:32:25 -03:00
Fred Amaral
b69a16c405
docs: update prose and examples to use ring- format
Transform all user-facing Ring component references from colon-based
notation (ring:) to a standardized hyphen-based format (ring-).

This change affects skill names, agent names, and slash commands in all
documentation, guides, and examples. The goal is to create a consistent
and user-friendly namespace that is easier to read and type.

For example:
- Skill/Agent references like `ring:code-reviewer` become `ring-code-reviewer`
- Slash commands like `/ring:codereview` become `/ring-codereview`

The colon-based format (`ring:`) is intentionally preserved in YAML
frontmatter (`name: ring:skill-name`) for internal metadata, separating
the user-facing display name from the internal tooling identifier.
2026-02-08 22:26:17 -03:00
Jefferson Rodrigues
df24b68bcf
refactor(standards): migrate to 10-gate development cycle with specialized testing modules
Major architectural change from 7-gate to 10-gate development cycle:

**New Gate Structure:**
- Gate 0: Implementation (unchanged)
- Gate 1: DevOps (unchanged)
- Gate 2: SRE (unchanged)
- Gate 3: Unit Testing (was combined 'Testing')
- Gate 4: Fuzz Testing (NEW)
- Gate 5: Property-Based Testing (NEW)
- Gate 6: Integration Testing (was optional Gate 3.5, now MANDATORY)
- Gate 7: Chaos Testing (NEW)
- Gate 8: Code Review (was Gate 4, now 5 reviewers)
- Gate 9: Validation (was Gate 5)

**Testing Standards Split:**
- testing-unit.md: 10 sections (table-driven, t.Parallel, loop capture, assertions)
- testing-fuzz.md: 5 sections (native Go fuzz, seed corpus)
- testing-property.md: 5 sections (quick.Check, invariants)
- testing-integration.md: 10 sections (testcontainers, fixtures, stubs)
- testing-chaos.md: 5 sections (Toxiproxy, failure injection)
- testing-benchmark.md: 4 sections (b.Loop pattern, Go 1.24+)

**Key Changes:**
- Integration testing is now MANDATORY (was optional)
- Added 4 new gate skills for specialized testing
- Removed combined testing section from quality.md
- Updated all references across dev-cycle, commands, and documentation
- Aligned with Test Writer standards (t.Parallel, loop capture, assertions)

X-Lerian-Ref: 0x1
2026-02-06 21:29:04 -03:00
Jefferson Rodrigues
8cbf9266c2
style(commands): normalize context words to lowercase per lexical salience
Fix wrongly capitalized context words:
- Line 81: 'ALL agent prompts' → 'all agent prompts'
- Line 85: 'Does NOT prevent' → 'Does not prevent'
- Line 137: 'Task file OR prompt' → 'Task file or prompt'
- Line 137: ', OR a direct prompt' → ', or a direct prompt'

Per style guideline: context words (all, any, only, each, every, not, no, and,
or, if, else) should be lowercase. Only enforcement words (MUST, STOP, etc.)
should be capitalized.

Generated-by: Claude
AI-Model: claude-opus-4-5-20251101
2026-02-02 12:26:25 -03:00
Jefferson Rodrigues
d0ab7d5fab
feat(commands): accept direct prompt without --prompt flag
Update dev-cycle and dev-refactor commands to accept prompts directly:
- Remove requirement for --prompt flag
- Prompt can be passed as remaining text after path/file and options
- Simplifies usage: `/ring:dev-cycle Implement multi-tenant support`
- Maintains backward compatibility with tasks file usage
- Update examples and argument parsing documentation

Before: /ring:dev-cycle --prompt "Implement feature"
After: /ring:dev-cycle Implement feature
Generated-by: Claude
AI-Model: claude-opus-4-5-20251101
2026-02-02 11:54:18 -03:00
Fred Amaral
445880db12
refactor: move output directories from .ring/ to docs/
Updates all output paths to use tracked docs/ directories instead of gitignored .ring/ folders. Ring no longer creates hidden project-local directories.

Changed paths: codereview output (.ring/codereview → docs/codereview), dev-team feedback (.ring/dev-team/feedback → docs/dev-team/feedback), handoffs now manual-only in docs/handoffs/.

Recreated handoff commands (create-handoff, resume-handoff) with simplified manual workflow - no auto-indexing or persistence.

X-Lerian-Ref: 0x1
2026-01-15 00:08:11 -03:00
Fred Amaral
6309c51213
refactor(core): prefix all components with 'ring:' for a unified API
feat(codereview): add data-flow and context-compilation analysis tools
2026-01-14 03:10:38 -03:00
Jefferson Rodrigues
449b7c5cfe
docs(dev-cycle): simplify tasks-file footnote wording
X-Lerian-Ref: 0x1
2026-01-13 15:44:41 -03:00
Jefferson Rodrigues
1f982baec9
feat(dev-cycle): add prompt-only mode for task generation
Allow running dev-cycle with just --prompt flag, without requiring a tasks file. The system will analyze the codebase and generate tasks internally before executing through the 6 gates.

Also removes --prompt from dev-refactor as it now relies on dev-cycle's prompt handling.

X-Lerian-Ref: 0x1
2026-01-13 12:48:51 -03:00
Jefferson Rodrigues
4a4e5bf5d4
fix: improve custom prompt validation and documentation consistency
- dev-cycle.md: Fix length guidance (50-75 words recommended, 500 hard limit)
- dev-cycle.md: Update conflict detection to use targeted patterns
- dev-cycle/SKILL.md: Replace gate-bypass example with compliant example
- dev-cycle/SKILL.md: Clarify custom_prompt forwarding via state file
- dev-refactor/SKILL.md: Strengthen language to MUST NOT for mandatory dims
- custom-prompt-validation.md: Add targeted regex patterns for conflict detection
- custom-prompt-validation.md: Fix inconsistent length recommendation
2026-01-13 12:21:57 -03:00
Jefferson Rodrigues
bd392c5aae
docs: enhance --prompt documentation and simplify precedence rules
dev-cycle.md:
- Add persistence, propagation, constraints sections
- Add gate protection with enforcement words (MUST, CANNOT, CRITICAL)
- Add conflict detection details (method, output, format)
- Add view/modify persisted prompt example

dev-refactor/SKILL.md:
- Add explicit validation steps (sanitize, length check, truncate)
- Reference shared pattern for gate protection

sre.md:
- Mark Precedence Decisions table rows as illustrative examples
- Simplify rendering note to single line
- Reference standards-workflow.md for precedence rules (reduce duplication)
2026-01-13 12:19:53 -03:00
Jefferson Rodrigues
cf2b85cfba
refactor(dev-cycle): simplify --prompt section, reference skill for details 2026-01-13 12:17:22 -03:00
Jefferson Rodrigues
17af5e4632
docs(dev-cycle): enhance --prompt flag documentation
- Add persistence details (custom_prompt in state file)
- Document lifecycle (scope, resume, reports)
- Add gate protection with enforcement words (MUST, CANNOT)
- Add conflict detection method and output format
- Add length constraints (recommended 300 words, hard limit 500 chars)
- Create shared-patterns/custom-prompt-validation.md
- Update dev-cycle/SKILL.md to reference shared pattern
2026-01-13 12:14:42 -03:00
Jefferson Rodrigues
c54cc96391
refactor(dev-team): consolidate custom prompt validation and clarify docs
- sre.md: clarify Precedence Decisions table note rendering (append vs replace)
- dev-cycle.md: simplify --prompt section, reference skill for full rules
- dev-refactor.md: clarify analysis vs execution scope, add --prompt constraints
- dev-cycle/SKILL.md: add canonical validation rules (500 chars, sanitization)
- dev-refactor/SKILL.md: reference dev-cycle skill for validation rules
2026-01-13 12:09:55 -03:00
Jefferson Rodrigues
3ebcc9588c
fix(dev-cycle): remove tasks file from --prompt examples
Generated-by: Claude
AI-Model: claude-sonnet-4-20250514
2026-01-13 12:04:08 -03:00
Jefferson Rodrigues
db284ddbeb
fix(dev-cycle): add simple --prompt example
Generated-by: Claude
AI-Model: claude-sonnet-4-20250514
2026-01-13 12:03:26 -03:00
Jefferson Rodrigues
c79f88ab65
fix(dev-team): remove 500 char limit, add --prompt handoff example
- Remove arbitrary 500 character limit on --prompt flag
- Add concrete example showing /dev-refactor to dev-cycle handoff flow

Generated-by: Claude
AI-Model: claude-sonnet-4-20250514
2026-01-13 12:00:11 -03:00
Jefferson Rodrigues
35b4e3905a
feat(dev-team): add --prompt flag validation and documentation
- dev-cycle.md: Add technical constraints, CRITICAL gates protection, conflicting prompt handling
- dev-refactor.md: Clarify mandatory analysis dimensions cannot be skipped
- dev-cycle/SKILL.md: Add custom_prompt schema validation (max_length, sanitization)
- dev-refactor/SKILL.md: Update Step 0.5 with MUST directive, conditional --prompt handoff

Generated-by: Claude
AI-Model: claude-sonnet-4-20250514
2026-01-13 11:57:34 -03:00
Jefferson Rodrigues
23243bbe3a
feat(dev-team): add --prompt parameter to dev-cycle and dev-refactor
Enable custom context injection for agent dispatches:
- dev-cycle: stores custom_prompt in state, injects into all gate agents
- dev-refactor: captures prompt, passes to analysis agents, forwards to dev-cycle

Updated files:
- commands/dev-cycle.md: added --prompt option
- commands/dev-refactor.md: added --prompt option
- skills/dev-cycle/SKILL.md: state schema, injection section
- skills/dev-refactor/SKILL.md: capture step, injection section, handoff

X-Lerian-Ref: 0x1
2026-01-13 11:46:23 -03:00
Fred Amaral
e047cad75b
docs: add pre-development documentation for Ring Continuity feature
docs(commands): add 'ring:' prefix to all command invocations
build(deps): remove requirements.txt in favor of dependency-map.md
chore(docs): remove obsolete handoff for namespace refactoring
2026-01-12 21:13:55 -03:00
Fred Amaral
67e5677a4e
refactor(plugins): unify namespace and archive legacy teams
This commit restructures the plugin ecosystem to improve maintainability,
simplify component invocation, and focus on high-value domains.

Key changes:
- **Unified Namespace:** All component invocations are standardized to the
 `ring:{component}` format, replacing the verbose `ring-{plugin}:...`
 prefix. This simplifies usage and abstracts the internal plugin
 structure.

- **Archive Legacy Plugins:** The `finance-team`, `ops-team`, `pmm-team`,
 and `pmo-team` plugins are moved to a new `.archive` directory.
 These plugins contained complex, outdated patterns and are now
 preserved for historical reference only.

- **Introduce FinOps Plugin:** A new, highly-focused `finops-team` plugin
 is added to handle Brazilian financial regulatory compliance (BACEN,
 RFB), consolidating critical functionality into a more focused package.

- **Update Documentation:** Core documentation (`ARCHITECTURE.md`,`README.md`,
 `CLAUDE.md`, `MANUAL.md`) and the plugin marketplace are updated to
 reflect the new structure and unified namespace.
2026-01-12 14:54:27 -03:00
Fred Amaral
c5e9c57799
refactor(naming): prefix default entities with 'ring:' namespace
This change introduces a namespacing convention for all built-in agents,
commands, and skills to prevent potential naming collisions with
user-defined entities.

All default entity names in the frontmatter are now prefixed with
'ring:'. For example, 'name: code-reviewer' becomes
'name: ring:code-reviewer'.

This creates a clear distinction between core framework components and
custom ones, improving the system's overall robustness and
extensibility.
2026-01-12 14:35:51 -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
17de142989
feat(dev-cycle): dynamic state path based on cycle type
- Feature cycles: docs/dev-cycle/current-cycle.json
- Refactor cycles: docs/dev-refactor/current-cycle.json
- Auto-detect based on source_file path (docs/refactor/* = refactor, else = feature)
- State object now includes state_path and cycle_type fields
- Updated all commands, hooks, and skills to check both locations
- Resume finds correct state file automatically
2025-12-22 20:05:45 -03:00
Jefferson Rodrigues
da712e024e
refactor: consolidate dev-review into requesting-code-review
- Delete duplicate dev-review skill from dev-team
- Update all references to use requesting-code-review
- Clarify skill modes: WITH INPUTS (any caller) vs STANDALONE (auto-detect)
- requesting-code-review now serves as the canonical Gate 4 skill
2025-12-22 20:00:24 -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
8ddfc9690c
fix: update remaining dev-team skill and shared-pattern references
Additional fixes for ring-{plugin}:{name} format in:
- dev-team/commands/dev-cycle.md (skill gate refs)
- dev-team/skills/dev-review/SKILL.md (reviewer refs)
- dev-team/skills/using-dev-team/SKILL.md (agent refs)
- dev-team/skills/shared-patterns/*.md (various refs)

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

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2025-12-15 20:27:43 -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
7d5aa9cf3d
fix: update remaining command references in skills and related commands tables
- Update finance-team/skills/using-finance-team/SKILL.md command references
- Update ops-team/skills/using-ops-team/SKILL.md command references
- Update pmo-team/skills/using-pmo-team/SKILL.md command references
- Update related commands tables in dev-team, finance-team, pmo-team commands

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

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2025-12-15 20:17: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
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
80d519009f
refactor(dev-team): remove metrics/alerting, add all agents to orchestrator
- Remove Prometheus metrics from SRE scope (focus on logging, tracing, health checks)

- Remove metrics section from sre.md and devops.md standards

- Update orchestrator-principle.md with all 22 agents across 5 plugins

- Add Agent Selection Guide and Red Flags sections

- Fix commands to load skills instead of duplicating workflow steps

- Update observability references from 'logs, traces, metrics' to 'logs, traces'

Generated-by: Claude
AI-Model: claude-opus-4-5-20251101
2025-12-13 21:59:52 -03:00
Jefferson Rodrigues
31e30d647f
docs(dev-team): add step-by-step execution instructions to commands
Replace generic skill loading with detailed step-by-step workflows for dev-cycle and dev-refactor commands. This provides clearer guidance on gate execution, agent dispatching, and checkpoint handling.

Generated-by: Claude
AI-Model: claude-opus-4-5-20251101
2025-12-13 13:41:06 -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
4ae11e3f6c
fix(dev-team): qualify all skill references in docs and commands
Update skill references to use fully qualified ring-{plugin}:{skill}
format across multiple files:

- using-dev-team/SKILL.md: Skills list (lines 411-413)
- dev-analysis/SKILL.md: Related Skills table
- dev-cycle.md: Gates table and feedback-loop reference
- dev-refactor.md: Loading message

Generated-by: Claude
2025-12-04 09:16:57 -03:00
Jefferson Rodrigues
01aec45217
fix(dev-team): correct gate sequence and standardize documentation
- Fix dev-devops sequence: before dev-sre (was dev-testing)
- Standardize "6-gate" naming across all documents
- Add missing Gate 2 (SRE) in dev-refactor workflow diagram
- Remove unused task-input.md template (tasks generated by pm-team/dev-refactor)
- Update dev-cycle prerequisites to reference task generators

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-12-04 01:25:31 -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
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