v5.0.0
FinalCode is a context-aware production certification and organization intelligence platform. It runs a senior-engineering audit across 13 quality gates, automatically adapts certification requirements to project type, architecture, deployment target, and maturity, validates engineering decisions to distinguish defects from intentional trade-offs, and extends analysis from single repositories to entire engineering organizations — correlating, comparing, and improving multi-repository ecosystems with cross-repository findings, organizational dashboards, team insights, and executive reporting. Produces a standardized Certification Report with a clear verdict: READY TO SHIP, READY WITH WARNINGS, or NOT READY.
Engineering quality is universal. Certification requirements are contextual. Not every deviation from best practice is a defect — FinalCode's Engineering Decision Validation Framework ensures intentional decisions and accepted trade-offs are recognized, not penalized.
FinalCode is an independent open-source project created and maintained by Dratiux. It is distributed through the Skills ecosystem and compatible with Skills-compatible AI coding agents.
- Quick Start
- Installation
- Workflow
- Quality Gates
- Certification Verdict
- Architecture
- Configuration
- Requirements
- Examples
- Engineering Documentation
- Contributing
- Security
- Support
- License
npx skills add dratiux/FinalCodeThen restart your AI coding agent and run:
Run FinalCode
Install FinalCode using the official skills.sh CLI:
npx skills add dratiux/FinalCodeskills.sh automatically detects your environment and installs FinalCode to the correct location. No manual configuration required.
Options:
| Flag | Description |
|---|---|
-g |
Install globally (available in all projects) |
-y |
Skip confirmation prompts |
--skill finalcode |
Install only the FinalCode skill |
--list |
List available skills before installing |
Examples:
# Global installation
npx skills add dratiux/FinalCode -g
# Non-interactive installation
npx skills add dratiux/FinalCode -y
# List available skills
npx skills add dratiux/FinalCode --listnpx skills add dratiux/FinalCode --updateFinalCode operates in four modes:
| Mode | Modifies Files | Use Case |
|---|---|---|
| Inspect | No | Audit the repository and produce a report |
| Repair | Yes | Apply verified fixes, then re-inspect |
| Refactor | Yes | Improve maintainability without behavior change |
| Certify | No | Final sign-off before release |
Run FinalCode # Inspect mode
Run FinalCode in Repair Mode # Repair mode
Run FinalCode in Refactor Mode # Refactor mode
Run FinalCode in Certify Mode # Certify mode
FinalCode evaluates repositories across 13 quality gates:
| Gate | Scope |
|---|---|
| Architecture | Project structure, module organization, dependency management |
| Code Quality | Complexity, duplication, naming conventions |
| Dead Code | Unused files, exports, variables, functions |
| Dependencies | Outdated packages, security vulnerabilities, license compliance |
| Type Safety | TypeScript strictness, type annotations, type errors |
| Error Handling | Try-catch blocks, error propagation, error recovery |
| Testing | Unit tests, integration tests, E2E tests, coverage |
| Performance | Bundle size, load times, memory usage |
| Security | 14-category security analysis (Security Gate 2.0) |
| Accessibility | WCAG compliance, screen reader support, keyboard navigation |
| UI Consistency | Design system compliance, component consistency |
| Documentation | README, API docs, inline comments, changelog |
| GitHub Readiness | Issue templates, PR templates, CI/CD, badges |
Detailed checklists: skills/finalcode/references/gates.md and skills/finalcode/references/security-gate.md.
| Verdict | Exit Code | Meaning |
|---|---|---|
| READY TO SHIP | 0 | All mandatory gates PASS |
| READY WITH WARNINGS | 1 | Mandatory gates PASS but warnings exist |
| NOT READY | 2 | One or more mandatory gates FAIL |
| NO PROJECT FOUND | 3 | No valid project detected |
FinalCode uses a Single Source of Truth (SSOT) architecture. All editable files live in skills/finalcode/.
skills/finalcode/
├── SKILL.md # Skill specification (v5.0.0)
├── core/ # Core engine + organization intelligence layer
│ ├── organization-registry.md # Repository inventory (v5.0.0)
│ ├── multi-repository-analysis.md # Cross-repo analysis (v5.0.0)
│ ├── repository-relationship-engine.md # Relationship graph (v5.0.0)
│ ├── shared-library-discovery.md # Duplicate detection (v5.0.0)
│ ├── engineering-organization-dashboard.md # Org dashboard (v5.0.0)
│ ├── organization-roadmap.md # Org-wide roadmap (v5.0.0)
│ ├── team-engineering-insights.md # Team metrics (v5.0.0)
│ ├── api-ecosystem-analysis.md # Cross-repo API analysis (v5.0.0)
│ ├── dependency-graph-v2.md # Org dependency graph (v5.0.0)
│ ├── platform-standardization.md # Standardization (v5.0.0)
│ ├── release-governance.md # Multi-repo release tracking (v5.0.0)
│ ├── organization-memory.md # Org knowledge (v5.0.0)
│ ├── organization-benchmark.md # Internal repo ranking (v5.0.0)
│ ├── executive-reporting.md # Executive summaries (v5.0.0)
│ ├── engineering-decision-engine.md # Observation classification (v4.5.0)
│ ├── decision-validation.md # Intent validation (v4.5.0)
│ ├── decision-confidence.md # Decision confidence (v4.5.0)
│ ├── tradeoff-registry.md # Trade-off standardization (v4.5.0)
│ ├── decision-explainability.md # Recommendation explanation (v4.5.0)
│ ├── recommendation-roi.md # Recommendation ROI (v4.5.0)
│ ├── engineering-recognition.md # Engineering strengths (v4.5.0)
│ ├── benchmark-intelligence.md # Benchmark comparison (v4.5.0)
│ ├── decision-timeline.md # Decision history (v4.5.0)
│ ├── engineering-intent-memory.md # Intent persistence (v4.5.0)
│ ├── decision-engine.md # Decision pipeline and rule matching
│ ├── policy-engine.md # Policy engine and built-in policies
│ ├── rule-registry.md # Rule registry and lifecycle
│ ├── report-engine.md # Report engine and section definitions
│ └── certification-engine.md # Certification pipeline and validation
├── plugins/ # Plugin layer
│ ├── sdk.md # Plugin SDK and registration
│ ├── profiles.md # Framework profiles (14 frameworks)
│ └── marketplace.md # Extension marketplace foundation
└── references/ # Reference documentation
├── examples.md # Worked example reports
├── gates.md # Quality gate checklists
├── security-gate.md # Security gate checklist
├── configuration.md # Configuration schema
├── plugins.md # Plugin architecture
├── health-score.md # Health score formula
├── confidence-model.md # Confidence model 2.0
├── finding-classification.md # Finding classification
├── explainability.md # Explainability engine
├── release-engine.md # Release blocker engine
└── architecture.md # System architecture
FinalCode can be configured without editing the skill. Place a finalcode.config.json at the repository root or .finalcode/config.json. See skills/finalcode/references/configuration.md for the schema.
| Policy | Use Case |
|---|---|
| POLICY-DEFAULT | Default behavior |
| POLICY-PRODUCTION | Production systems |
| POLICY-ENTERPRISE | Enterprise environments |
| POLICY-STARTUP | Rapid development |
| POLICY-OPENSOURCE | Open source projects |
| POLICY-EDUCATIONAL | Learning projects |
| POLICY-MINIMAL | Minimum checks |
| POLICY-STRICT | Maximum strictness |
- Explicit configuration (
policy: "POLICY-PRODUCTION") - Project profile default
- Command-line flag (
--policy POLICY-ENTERPRISE) - Default (
POLICY-DEFAULT)
| Requirement | Minimum |
|---|---|
| Node.js | 18+ |
| npm | 9+ |
FinalCode works with any Skills-compatible AI coding agent. Refer to the Skills documentation for the latest supported environments.
Certification: READY TO SHIP
Exit Code: 0
Health Score: 94 / 100
Grade: A+
Certification: NOT READY
Exit Code: 2
Health Score: 67 / 100
Grade: C+
Blocking Issues: 3
Full examples: skills/finalcode/references/examples.md.
FinalCode generates persistent documentation inside .finalcode/:
| Document | Purpose |
|---|---|
reports/<timestamp>-<mode>.md |
Immutable execution reports |
CHANGE_REPORT.md |
Engineering change log |
REFACTOR_REPORT.md |
Refactoring history |
FINALCODE_SUMMARY.md |
Executive summary |
CERTIFICATION_HISTORY.md |
Certification log |
TREND.md |
Historical trend analysis |
BASELINE.md |
First-execution baseline |
Reports are immutable. New executions create new timestamped files.
See CONTRIBUTING.md.
See SECURITY.md.
See SUPPORT.md for troubleshooting.
MIT License. See LICENSE.
Created by Dratiux. Built for the Skills ecosystem.
