sincron-plan 1.0.0

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "sincron-plan",
+  "version": "1.0.0",
+  "description": "Plugin de planejamento estruturado e mapeamento de codebase para Claude Code. Do requisito ao PRD, com questionamento inteligente.",
+  "bin": {
+    "sincron-plan": "bin/install.js"
+  },
+  "files": [
+    "bin",
+    "commands",
+    "agents",
+    "templates",
+    "docs"
+  ],
+  "keywords": [
+    "planejamento",
+    "prd",
+    "requisitos",
+    "codebase",
+    "mapeamento",
+    "documentacao",
+    "ia",
+    "inteligencia-artificial",
+    "claude-code",
+    "plugin"
+  ],
+  "author": "Sincron Framework",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/MLTCorp/sincron-auto.git"
+  },
+  "homepage": "https://github.com/MLTCorp/sincron-auto/tree/sincron-plan",
+  "bugs": {
+    "url": "https://github.com/MLTCorp/sincron-auto/issues"
+  },
+  "engines": {
+    "node": ">=16.7.0"
+  },
+  "dependencies": {},
+  "devDependencies": {}
+}

package/templates/PRD.md

@@ -0,0 +1,101 @@
+# PRD: [Project Name]
+
+**Generated:** [YYYY-MM-DD]
+**Source:** Sincron-Plan
+
+## Executive Summary
+[2-3 sentences describing what this is]
+
+## Problem Statement
+[What problem this solves]
+
+## Target Users
+[Who will use this]
+
+### User Personas
+| Persona | Description | Primary Goals |
+|---------|-------------|---------------|
+| [name] | [who they are] | [what they want] |
+
+## Success Metrics
+[How we know it's working]
+
+| Metric | Target | How to Measure |
+|--------|--------|----------------|
+| [name] | [value] | [method] |
+
+## Requirements
+
+### v1 (MVP)
+| ID | Requirement | Phase | Priority |
+|----|-------------|-------|----------|
+| REQ-001 | [description] | 1 | Must Have |
+
+### v2 (Future)
+| ID | Requirement | Rationale for Deferral |
+|----|-------------|------------------------|
+| REQ-010 | [description] | [why not v1] |
+
+### Out of Scope
+| Feature | Reason |
+|---------|--------|
+| [feature] | [why excluded] |
+
+## Phases
+
+### Phase 1: [Name]
+**Goal**: [What this delivers]
+**Requirements**: REQ-001, REQ-002, ...
+**Success Criteria**:
+1. [Observable behavior]
+2. [Observable behavior]
+
+**Deliverables**:
+- [ ] [Deliverable 1]
+- [ ] [Deliverable 2]
+
+### Phase 2: [Name]
+**Goal**: [What this delivers]
+**Requirements**: REQ-003, REQ-004, ...
+**Depends On**: Phase 1
+**Success Criteria**:
+1. [Observable behavior]
+2. [Observable behavior]
+
+## Technical Decisions
+| Decision | Options Considered | Choice | Rationale |
+|----------|-------------------|--------|-----------|
+| [topic] | [options] | [chosen] | [why] |
+
+## Constraints
+| Type | Constraint | Impact |
+|------|------------|--------|
+| Technical | [limitation] | [how it affects design] |
+| Business | [requirement] | [how it affects scope] |
+
+## Risks
+| Risk | Likelihood | Impact | Mitigation |
+|------|------------|--------|------------|
+| [risk] | High/Med/Low | High/Med/Low | [action] |
+
+## Dependencies
+| Dependency | Type | Status | Owner |
+|------------|------|--------|-------|
+| [what] | Internal/External | Resolved/Pending | [who] |
+
+## Open Questions
+| Question | Impact | Decision Deadline |
+|----------|--------|-------------------|
+| [question] | [what depends on it] | [when needed] |
+
+---
+
+## Appendix
+
+### Glossary
+| Term | Definition |
+|------|------------|
+| [term] | [meaning in this context] |
+
+### References
+- [Document/Link]

package/templates/ROADMAP.md

@@ -0,0 +1,101 @@
+# Roadmap: [Project Name]
+
+**Generated:** [YYYY-MM-DD]
+**Source:** Sincron-Plan
+
+## Vision
+[One sentence describing the end state]
+
+## Phases Overview
+
+```
+┌─────────────┐     ┌─────────────┐     ┌─────────────┐
+│   Phase 1   │────▶│   Phase 2   │────▶│   Phase 3   │
+│   [Name]    │     │   [Name]    │     │   [Name]    │
+└─────────────┘     └─────────────┘     └─────────────┘
+```
+
+## Phase 1: [Name]
+
+### Goal
+[What this phase delivers in one sentence]
+
+### Key Deliverables
+- [ ] [Deliverable 1]
+- [ ] [Deliverable 2]
+- [ ] [Deliverable 3]
+
+### Requirements Included
+- REQ-001: [brief description]
+- REQ-002: [brief description]
+
+### Success Criteria
+1. [Observable outcome]
+2. [Observable outcome]
+
+### Dependencies
+- None (foundation phase)
+
+---
+
+## Phase 2: [Name]
+
+### Goal
+[What this phase delivers in one sentence]
+
+### Key Deliverables
+- [ ] [Deliverable 1]
+- [ ] [Deliverable 2]
+
+### Requirements Included
+- REQ-003: [brief description]
+- REQ-004: [brief description]
+
+### Success Criteria
+1. [Observable outcome]
+2. [Observable outcome]
+
+### Dependencies
+- Phase 1 complete
+
+---
+
+## Phase 3: [Name]
+
+### Goal
+[What this phase delivers in one sentence]
+
+### Key Deliverables
+- [ ] [Deliverable 1]
+- [ ] [Deliverable 2]
+
+### Requirements Included
+- REQ-005: [brief description]
+
+### Success Criteria
+1. [Observable outcome]
+
+### Dependencies
+- Phase 2 complete
+
+---
+
+## Future Considerations (v2+)
+
+### Deferred Features
+| Feature | Phase | Rationale |
+|---------|-------|-----------|
+| [feature] | v2 | [why deferred] |
+
+### Potential Extensions
+- [Extension idea 1]
+- [Extension idea 2]
+
+---
+
+## Risk Checkpoints
+
+| After Phase | Check | Action if Failed |
+|-------------|-------|------------------|
+| 1 | [validation criteria] | [pivot/adjust] |
+| 2 | [validation criteria] | [pivot/adjust] |

package/templates/codebase/ARCHITECTURE.md

@@ -0,0 +1,45 @@
+# Architecture: [Project Name]
+
+**Analysis Date:** [YYYY-MM-DD]
+
+## Pattern Overview
+[Architectural pattern: MVC, Layered, Microservices, etc]
+
+## Layers
+| Layer | Purpose | Key Files |
+|-------|---------|-----------|
+| [name] | [what it does] | `path/to/files` |
+
+## Data Flow
+[How data moves through the system]
+
+```
+[User Action]
+     │
+     ▼
+[Entry Point] ─────▶ [Processing Layer]
+     │                      │
+     │                      ▼
+     │              [Data Layer]
+     │                      │
+     ▼                      ▼
+[Response] ◀──────── [Output]
+```
+
+## Entry Points
+- [Entry point]: `path/to/file`
+
+## Key Abstractions
+- [Concept]: [What it represents]
+
+## State Management
+- **Approach**: [How state is managed]
+- **Location**: `path/to/state`
+
+## External Integrations
+| Service | Purpose | Integration Point |
+|---------|---------|-------------------|
+| [name] | [why] | `path/to/file` |
+
+## Design Patterns Used
+- [Pattern]: [Where and why]

package/templates/codebase/CONCERNS.md

@@ -0,0 +1,53 @@
+# Concerns: [Project Name]
+
+**Analysis Date:** [YYYY-MM-DD]
+
+## Tech Debt
+| Area | Issue | Impact | Fix Approach |
+|------|-------|--------|--------------|
+| `path` | [problem] | [impact] | [how to fix] |
+
+## Known Issues
+| Symptom | Trigger | Workaround |
+|---------|---------|------------|
+| [what happens] | [when/how] | [temporary fix] |
+
+## Fragile Areas
+| Location | Why Fragile | Safe Modification Approach |
+|----------|-------------|---------------------------|
+| `path/to/file` | [reason] | [how to change safely] |
+
+## Security Considerations
+| Risk | Current Mitigation | Recommendation |
+|------|-------------------|----------------|
+| [vulnerability] | [what's in place] | [what should be done] |
+
+## Test Coverage Gaps
+| What's Not Tested | Risk Level | Priority |
+|-------------------|------------|----------|
+| [area/feature] | High/Medium/Low | P1/P2/P3 |
+
+## Performance Concerns
+| Area | Issue | Impact | Recommendation |
+|------|-------|--------|----------------|
+| `path` | [problem] | [user impact] | [fix] |
+
+## Deprecated Code
+| Location | Status | Migration Path |
+|----------|--------|----------------|
+| `path` | [active/unused] | [how to remove] |
+
+## Missing Documentation
+| Area | What's Needed | Priority |
+|------|---------------|----------|
+| [component/feature] | [doc type] | P1/P2/P3 |
+
+## Recommendations Summary
+### High Priority
+1. [Action item]
+
+### Medium Priority
+1. [Action item]
+
+### Low Priority
+1. [Action item]

package/templates/codebase/STACK.md

@@ -0,0 +1,34 @@
+# Stack: [Project Name]
+
+**Analysis Date:** [YYYY-MM-DD]
+
+## Languages
+- [Language] [Version] - [Where used]
+
+## Runtime
+- **Environment**: [Node.js/Python/etc] [Version]
+- **Package Manager**: [npm/yarn/pip/etc]
+
+## Frameworks
+- **Core**: [Framework] [Version]
+- **Testing**: [Framework]
+- **Build**: [Tool]
+
+## Key Dependencies
+| Package | Version | Purpose |
+|---------|---------|---------|
+| [name] | [ver] | [why] |
+
+## Configuration
+- **Environment**: [.env pattern]
+- **Build**: [config files]
+
+## Development Tools
+- **Linting**: [Tool]
+- **Formatting**: [Tool]
+- **Type Checking**: [Tool]
+
+## Scripts Disponíveis
+| Script | Comando | Descrição |
+|--------|---------|-----------|
+| [name] | [command] | [what it does] |

package/templates/codebase/STRUCTURE.md

@@ -0,0 +1,46 @@
+# Structure: [Project Name]
+
+**Analysis Date:** [YYYY-MM-DD]
+
+## Directory Layout
+```
+project/
+├── src/
+│   ├── [dir]/     # [purpose]
+│   └── [dir]/     # [purpose]
+├── tests/
+└── [other]/
+```
+
+## Where to Add New Code
+| Type | Location | Example |
+|------|----------|---------|
+| Component | `src/components/` | `Button.tsx` |
+| API Route | `src/api/` | `users.ts` |
+| Utility | `src/utils/` | `format.ts` |
+| Type/Interface | `src/types/` | `user.ts` |
+| Hook | `src/hooks/` | `useAuth.ts` |
+| Service | `src/services/` | `api.ts` |
+| Test | `tests/` | `*.test.ts` |
+
+## Naming Conventions
+- Files: [pattern]
+- Functions: [pattern]
+- Components: [pattern]
+- Constants: [pattern]
+- Types/Interfaces: [pattern]
+
+## Import Conventions
+- **Absolute imports**: [pattern]
+- **Relative imports**: [when to use]
+- **Barrel exports**: [index.ts pattern]
+
+## Key Files
+| File | Purpose | Notes |
+|------|---------|-------|
+| `path/to/file` | [what it does] | [important notes] |
+
+## Module Boundaries
+| Module | Depends On | Depended By |
+|--------|------------|-------------|
+| [name] | [modules] | [modules] |