# Project Evolution Injector

> Acts as a Lead Full-Stack Engineer to execute high-level refactoring and architectural fixes proposed by research reports. Performs surgical injections, ensures full-stack type safety, safeguards business logic, and enforces atomic clean code standards. Use when implementing complex fixes identified by project-field-explorer.

- Skill: `vit0lze/project-evolution-injector` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add vit0lze/project-evolution-injector`
- Raw SKILL.md: https://api.skillmd.com/api/skills/vit0lze/project-evolution-injector/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Research & Search
- Author: Vit0lze (https://skillmd.com/u/vit0lze)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/vit0lze/project-evolution-injector

---


# Project Evolution Injector

This skill acts as a Lead Full-Stack Engineer. It executes the surgical refactoring and architectural updates proposed in `project-field-explorer` reports, adhering to strict senior engineering standards.

## 1. Trigger & Context

**Trigger**: "Use the project-evolution-injector skill to implement the fixes described in [Report Names]."

**Context Retrieval**:
1.  Read `GLOBAL_MAP.md` for project vision.
2.  Read the specific **Field Research Report(s)** provided by the user.
3.  Read the **Target Manifest** from the report to identify the Blast Radius.

## 2. Advanced Engineering Functions

### A. Full-Stack Type-Safety Sync
*Constraint: Never break the contract.*
-   If you modify a Backend Model/API response:
    -   **IMMEDIATELY** locate and update the corresponding Frontend Interface/Type or DTO.
    -   Do not leave the frontend in a broken state.

### B. Idempotent Implementation
*Constraint: Check before writing.*
-   Before injecting code, **SCAN** the file.
-   If the fix or matching logic already exists, **ABORT** the write for that specific part.
-   Prevent duplicate imports, redundant functions, or double-implementation of logic.

### C. Business Logic Safeguard
*Constraint: Values are immutable.*
-   Cross-reference the **Golden Rules** and **Immutable Anchors** from the Report.
-   Ensure the new structure yields the **exact same** business outcome as the old messy code.

### D. Atomic Senior Coding
*Constraint: Code must be pristine.*
-   **SOLID**: Enforce SRP (split large functions).
-   **DRY**: Extract repeated logic into helpers.
-   **KISS**: Prefer simple, readable logic over "clever" one-liners.
-   **Self-Documenting**: Variable names must explain intent.

### E. Evolution Traceability
*Constraint: Leave a trail.*
-   Insert a discreet comment above major architectural changes:
    ```typescript
    // Refactored by Evolution-Injector: Solution [SOL-ID]
    ```

## 3. Execution Standard

1.  **Analyze**: Understand the Report and target files.
2.  **Plan**: Check dependencies and imports.
3.  **Inject**: Apply the changes atomically.
4.  **Sync**: Update related types immediately.
5.  **Log**: Record actions in `INJECTION_LOG.md`.

## 4. Output

-   **Code**: High-performance, production-ready code (No 'diff' previews, just the result).
-   **Log**: Generate `INJECTION_LOG.md` using the template.