documentação do sistema

.context/skills/README.md

@@ -0,0 +1,73 @@
+# Skills
+
+On-demand expertise for AI agents. Skills are task-specific procedures that get activated when relevant.
+
+> Project: Vendaweb-portal
+
+## How Skills Work
+
+1. **Discovery**: AI agents discover available skills
+2. **Matching**: When a task matches a skill's description, it's activated
+3. **Execution**: The skill's instructions guide the AI's behavior
+
+## Available Skills
+
+### Built-in Skills
+
+| Skill | Description | Phases |
+|-------|-------------|--------|
+| [Commit Message](./commit-message/SKILL.md) | Generate commit messages following conventional commits with scope detection | E, C |
+| [Pr Review](./pr-review/SKILL.md) | Review pull requests against team standards and best practices | R, V |
+| [Code Review](./code-review/SKILL.md) | Review code quality, patterns, and best practices | R, V |
+| [Test Generation](./test-generation/SKILL.md) | Generate comprehensive test cases for code | E, V |
+| [Documentation](./documentation/SKILL.md) | Generate and update technical documentation | P, C |
+| [Refactoring](./refactoring/SKILL.md) | Safe code refactoring with step-by-step approach | E |
+| [Bug Investigation](./bug-investigation/SKILL.md) | Systematic bug investigation and root cause analysis | E, V |
+| [Feature Breakdown](./feature-breakdown/SKILL.md) | Break down features into implementable tasks | P |
+| [Api Design](./api-design/SKILL.md) | Design RESTful APIs following best practices | P, R |
+| [Security Audit](./security-audit/SKILL.md) | Security review checklist for code and infrastructure | R, V |
+
+## Creating Custom Skills
+
+Create a new skill by adding a directory with a `SKILL.md` file:
+
+```
+.context/skills/
+└── my-skill/
+    ├── SKILL.md          # Required: skill definition
+    └── templates/        # Optional: helper resources
+        └── checklist.md
+```
+
+### SKILL.md Format
+
+```yaml
+---
+name: my-skill
+description: When to use this skill
+phases: [P, E, V]  # Optional: PREVC phases
+mode: false        # Optional: mode command?
+---
+
+# My Skill
+
+## When to Use
+[Description of when this skill applies]
+
+## Instructions
+1. Step one
+2. Step two
+
+## Examples
+[Usage examples]
+```
+
+## PREVC Phase Mapping
+
+| Phase | Name | Skills |
+|-------|------|--------|
+| P | Planning | feature-breakdown, documentation, api-design |
+| R | Review | pr-review, code-review, api-design, security-audit |
+| E | Execution | commit-message, test-generation, refactoring, bug-investigation |
+| V | Validation | pr-review, code-review, test-generation, security-audit |
+| C | Confirmation | commit-message, documentation |

.context/skills/api-design/SKILL.md

@@ -0,0 +1,10 @@
+---
+type: skill
+name: Api Design
+description: Design RESTful APIs following best practices
+skillSlug: api-design
+phases: [P, R]
+generated: 2026-04-29
+status: unfilled
+scaffoldVersion: "2.0.0"
+---

.context/skills/bug-investigation/SKILL.md

@@ -0,0 +1,10 @@
+---
+type: skill
+name: Bug Investigation
+description: Systematic bug investigation and root cause analysis
+skillSlug: bug-investigation
+phases: [E, V]
+generated: 2026-04-29
+status: unfilled
+scaffoldVersion: "2.0.0"
+---

.context/skills/code-review/SKILL.md

@@ -0,0 +1,10 @@
+---
+type: skill
+name: Code Review
+description: Review code quality, patterns, and best practices
+skillSlug: code-review
+phases: [R, V]
+generated: 2026-04-29
+status: unfilled
+scaffoldVersion: "2.0.0"
+---

.context/skills/commit-message/SKILL.md

@@ -0,0 +1,10 @@
+---
+type: skill
+name: Commit Message
+description: Generate commit messages following conventional commits with scope detection
+skillSlug: commit-message
+phases: [E, C]
+generated: 2026-04-29
+status: unfilled
+scaffoldVersion: "2.0.0"
+---

.context/skills/documentation/SKILL.md

@@ -0,0 +1,10 @@
+---
+type: skill
+name: Documentation
+description: Generate and update technical documentation
+skillSlug: documentation
+phases: [P, C]
+generated: 2026-04-29
+status: unfilled
+scaffoldVersion: "2.0.0"
+---

.context/skills/feature-breakdown/SKILL.md

@@ -0,0 +1,10 @@
+---
+type: skill
+name: Feature Breakdown
+description: Break down features into implementable tasks
+skillSlug: feature-breakdown
+phases: [P]
+generated: 2026-04-29
+status: unfilled
+scaffoldVersion: "2.0.0"
+---

.context/skills/pr-review/SKILL.md

@@ -0,0 +1,10 @@
+---
+type: skill
+name: Pr Review
+description: Review pull requests against team standards and best practices
+skillSlug: pr-review
+phases: [R, V]
+generated: 2026-04-29
+status: unfilled
+scaffoldVersion: "2.0.0"
+---

.context/skills/refactoring/SKILL.md

@@ -0,0 +1,10 @@
+---
+type: skill
+name: Refactoring
+description: Safe code refactoring with step-by-step approach
+skillSlug: refactoring
+phases: [E]
+generated: 2026-04-29
+status: unfilled
+scaffoldVersion: "2.0.0"
+---

.context/skills/security-audit/SKILL.md

@@ -0,0 +1,10 @@
+---
+type: skill
+name: Security Audit
+description: Security review checklist for code and infrastructure
+skillSlug: security-audit
+phases: [R, V]
+generated: 2026-04-29
+status: unfilled
+scaffoldVersion: "2.0.0"
+---

.context/skills/test-generation/SKILL.md

@@ -0,0 +1,10 @@
+---
+type: skill
+name: Test Generation
+description: Generate comprehensive test cases for code
+skillSlug: test-generation
+phases: [E, V]
+generated: 2026-04-29
+status: unfilled
+scaffoldVersion: "2.0.0"
+---