Commit graph

17 commits

Author SHA1 Message Date
Fred Amaral
9cb5a72737
fix(codereview): align reviewer references and harden lib-commons/multi-tenant agents
Propagates the 10-reviewer peer list across agent frontmatter, Position/Critical prose, shared-patterns, skill dispatchers, gate validators, and docs — resolving drift left behind when multi-tenant-reviewer and lib-commons-reviewer were added to the pool. Also fixes broken shared-pattern paths in lib-commons-reviewer and adds substantive blocker criteria to multi-tenant-reviewer plus codebase-context severity heuristic (Lerian third-rail vs external recommendation) to lib-commons-reviewer.

X-Lerian-Ref: 0x1
2026-04-18 20:18:16 -03:00
Fred Amaral
600a505c9a
docs: propagate performance-reviewer as 8th codereview agent across all downstream references
Update all skills, agents, shared patterns, docs, and platform configs that still referenced 7 code review agents to reflect the 8th reviewer (ring:performance-reviewer). Includes agent self-descriptions, dispatch instructions, anti-rationalization tables, slicing math, gate tables, and opencode schema definitions.

X-Lerian-Ref: 0x1
2026-04-14 15:53:45 -03:00
Fred Amaral
c1d4fe6d45
feat(review): add dead-code-reviewer agent for orphan detection
Introduces a new parallel reviewer, `ring:dead-code-reviewer`, to
systematically identify orphaned code resulting from changes. This
enhances codebase hygiene by detecting unused helpers, types, and
tests, thereby reducing technical debt and improving maintainability.

The parallel code review system is expanded from 6 to 7 concurrent
reviewers. All related workflows, skills, commands, and documentation
have been updated to integrate this new capability.

- Add the `ring:dead-code-reviewer` agent, which analyzes code across
 three concentric rings (target, direct dependents, ripple effect) to
 find unreachable code.
- Update the `/ring:codereview` command and `ring:requesting-code-review`
 skill to dispatch all 7 reviewers in a single parallel step.
- Adjust project documentation, including architecture diagrams, manuals,
 and agent guides, to reflect the 7-reviewer workflow.
2026-03-09 21:17:22 -03:00
Fred Amaral
0e7e5ca396
refactor: decouple agents from specific model requirements
Removes the hard-coded `model: "opus"` requirement from all agent
definitions, skill examples, and command documentation. The orchestrator
is now responsible for model selection, making the agent framework more
flexible and model-agnostic.

Key changes include:
- Removing the `model` parameter from all agent frontmatter and Task
 tool examples.
- Deleting the "Model Requirement" hard gate and self-verification
 sections from all agent prompts. This simplifies the prompts and
 removes model-specific enforcement logic.
- Updating core documentation (ARCHITECTURE, MANUAL, README) to reflect
 that model selection is an orchestrator concern.
- Removing redundant `changelog` and `last_updated` fields from agent
 frontmatter, as this information is tracked by source control.

This architectural shift allows the orchestrator to dynamically choose
the best model for a given task based on complexity, cost, or speed,
without being constrained by the agent's definition. It simplifies
agent maintenance and prepares the system for easier integration of
future AI models.
2026-03-08 16:33:12 -03:00
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
b35e95cfbb
refactor(dev-refactor): rename artifact path and define timestamp format
Renames docs/refactor/ to docs/ring:dev-refactor/ to match the skill namespace. Defines explicit timestamp format YYYY-MM-DDTHH:MM:SS for consistent directory naming.

X-Lerian-Ref: 0x1
2026-02-07 20:26:33 -03:00
Jefferson Rodrigues
c484ab879f docs: update root documentation with production standards
Add production-readiness-audit to skill references, update dev-cycle command documentation, and add standards-coverage-table references.

Updated files:
- CLAUDE.md: Add dev-cycle command to slash commands
- README.md: Add production-readiness-audit to audit skills section
- MANUAL.md: Add production-readiness-audit example to skills list
- docs/WORKFLOWS.md: Add dev-cycle workflow reference
- docs/PROMPT_ENGINEERING.md: Add standards-agent synchronization pattern

X-Lerian-Ref: 0x1
2026-02-06 19:33:39 -03:00
Fred Amaral
1070aed7e2
docs: remove model="opus" from documentation examples
Update all documentation that shows agent dispatch patterns to remove

explicit model parameter. Model selection is delegated to orchestrators.

X-Lerian-Ref: 0x1
2026-02-04 18:18:25 -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
Jefferson Rodrigues
0d35eee786
refactor: move Strategic Spacing section to PROMPT_ENGINEERING.md
Move detailed spacing examples from CLAUDE.md to canonical location.
CLAUDE.md now references PROMPT_ENGINEERING.md for complete details.

Generated-by: Claude
AI-Model: claude-sonnet-4-20250514
2026-01-06 17:18:18 -03:00
Jefferson Rodrigues
fa58a5e86b
refactor: move Semantic Block Tags to PROMPT_ENGINEERING.md
Move detailed tag documentation from CLAUDE.md to canonical location.
CLAUDE.md now references PROMPT_ENGINEERING.md for complete tag details.
Also updated examples to use fully qualified agent names.

Generated-by: Claude
AI-Model: claude-sonnet-4-20250514
2026-01-06 17:14:15 -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
4a0175c3d7
docs(dev-refactor): add Task Tool Invocation pattern and use fully qualified agent names
- Add Task Tool Invocation section to PROMPT_ENGINEERING.md as canonical pattern
- Update dev-refactor to use ring-default:codebase-explorer consistently
- Add explicit Write tool parameter box for artifact creation
- Add Artifact Output section documenting codebase-report.md as Step 3 input
- Add dependency chain diagram showing Step 2.5 → artifact → Step 3 flow

Generated-by: Claude
AI-Model: claude-opus-4-5-20251101
2025-12-12 22:35:55 -03:00
Jefferson Rodrigues
85046472dd
refactor(docs): extract CTC template to canonical location
Moves Code Transformation Context (CTC) template from dev-refactor/SKILL.md to docs/PROMPT_ENGINEERING.md as single source of truth. dev-refactor now references the canonical location with a minimal checklist.

Key changes:

- Add canonical CTC template to PROMPT_ENGINEERING.md

- Replace 108-line duplicated block with 30-line reference

- Add runtime line range derivation requirement (no hardcoded line numbers)

Generated-by: Claude
AI-Model: claude-opus-4-5-20251101
2025-12-12 13:55:09 -03:00
Jefferson Rodrigues
356e5a9d12
refactor(docs): extract reference docs from CLAUDE.md to reduce file size
Extract detailed documentation into separate reference files to reduce CLAUDE.md from 43KB to 19KB, eliminating the large file warning.

New reference documentation:
- docs/PROMPT_ENGINEERING.md: Assertive language patterns for agent prompts
- docs/AGENT_DESIGN.md: Agent output schemas and standards compliance
- docs/WORKFLOWS.md: Detailed workflow instructions for skills/agents/hooks

CLAUDE.md now contains condensed summaries with links to full docs.

Generated-by: Claude
AI-Model: claude-opus-4-5-20251101
2025-12-11 12:34:45 -03:00