plankit-cli 1.0.1 → 1.3.0

package/templates/angular-skills/gemini/angular-extract-store/SKILL.md

@@ -0,0 +1,20 @@
+---
+name: angular-extract-store
+description: Extract server/user state from a component into a feature-scoped store.
+---
+
+# /extract-store
+
+Move state and state transitions into a store without turning it into a dumping ground.
+
+## Workflow
+1. Detect existing state and classify: SERVER STATE, USER STATE, DERIVED, EPHEMERAL UI.
+2. Keep ephemeral UI (e.g. dialogOpen) local; move server/user/derived state into the store.
+3. Determine provider scope from the app (component / route / feature / root) — do not default everything to root.
+
+## Safeguard
+Keep presentation and DOM logic out of the store. Store = state + transitions + relevant orchestration only.
+
+# angular-extract-store
+
+Project Discovery must run first. Execute the workflow with the target arguments from the request.

package/templates/angular-skills/gemini/angular-feature/SKILL.md

@@ -0,0 +1,25 @@
+---
+name: angular-feature
+description: Build an entire Angular feature while respecting the application existing architecture.
+---
+
+# /feature
+
+High-level feature builder that composes lower-level commands.
+
+## Workflow
+1. Turn the request into capabilities (pages, data, state, UI, routes).
+2. Discover the closest existing feature (e.g. --like customers).
+3. Map capabilities onto existing repository patterns.
+4. Compose: clone-pattern -> component-from -> wire-api -> form-from-model -> generate-tests.
+
+## Safeguard
+Do not invent infrastructure. If existing features do not use stores/repositories/facades, do not introduce them here.
+
+## Options
+- --like <feature>   pattern reference
+- --plan             output only the plan (files, patterns, dependencies, routes, tests) without writing
+
+# angular-feature
+
+Project Discovery must run first. Execute the workflow with the target arguments from the request.

package/templates/angular-skills/gemini/angular-fixtures/SKILL.md

@@ -0,0 +1,24 @@
+---
+name: angular-fixtures
+description: Generate reusable fixtures from TypeScript domain models with override support.
+---
+
+# /fixtures
+
+Create test/dev fixtures from existing models.
+
+## Workflow
+1. Given a model (e.g. Order), generate a factory: createOrder(overrides = {}) with sensible defaults and nested factories.
+2. Compose states where valuable.
+
+## Options
+- --count <n>        generate an array of n fixtures
+- --states           generate named states (pendingOrder, completedOrder, cancelledOrder, emptyOrder, largeOrder)
+- --edge-cases       generate edge cases (longName, missingOptionalFields, unicodeName, inactiveUser)
+
+## Integration
+Feeds /component-from, /table-from-model, /generate-tests.
+
+# angular-fixtures
+
+Project Discovery must run first. Execute the workflow with the target arguments from the request.

package/templates/angular-skills/gemini/angular-form-from-model/SKILL.md

@@ -0,0 +1,23 @@
+---
+name: angular-form-from-model
+description: Generate an Angular form from a TypeScript model, inferring field types, controls, and validation.
+---
+
+# /form-from-model
+
+Build forms from domain models with semantic inference.
+
+## Workflow
+1. Understand field semantics (email -> email input, roleId -> select, active -> toggle, birthDate -> date).
+2. Reuse existing project form components (app-field, app-input, app-select, app-toggle).
+3. Discover validation from existing DTOs/sibling forms/schemas; separate KNOWN from INFERRED validation — never hallucinate constraints.
+4. Respect Reactive Forms vs Signal Forms based on project version.
+5. Generate a mapping layer (toCreateDto / toFormModel) instead of coupling DTOs to the UI.
+
+## Options
+- --create | --edit | --dialog | --stepper
+- --like <form>      reference form
+
+# angular-form-from-model
+
+Project Discovery must run first. Execute the workflow with the target arguments from the request.

package/templates/angular-skills/gemini/angular-generate-tests/SKILL.md

@@ -0,0 +1,21 @@
+---
+name: angular-generate-tests
+description: Generate behavior-focused tests, deriving behaviors and filling gaps only.
+---
+
+# /generate-tests
+
+Test behavior, not implementation details.
+
+## Workflow
+1. Derive behaviors for the target (form init, validation, derived values, submit blocking, request emission, error display, disabled states).
+2. Find existing coverage and generate only missing tests.
+3. Use given/when/then behavior, not expect(component).toBeTruthy().
+
+## Options
+- --diff             generate tests around changed behaviors only
+- target types: component | service | store | route (--navigation)
+
+# angular-generate-tests
+
+Project Discovery must run first. Execute the workflow with the target arguments from the request.

package/templates/angular-skills/gemini/angular-modernize/SKILL.md

@@ -0,0 +1,21 @@
+---
+name: angular-modernize
+description: Orchestrate incremental Angular migrations, building/testing between each stage.
+---
+
+# /modernize
+
+Treat this as a migration orchestrator, not an LLM rewrite.
+
+## Workflow
+1. Determine the Angular version and applicable migrations (standalone, built-in control flow, inject(), signal inputs, output(), signal queries).
+2. Make transformations individually selectable and apply them one at a time.
+3. Categorize: SAFE AUTOMATED (*ngIf->@if), SAFE WITH VERIFICATION (constructor DI->inject()), ARCHITECTURAL (local state->Signals), NOT RECOMMENDED (working RxJS->Signals).
+4. Build/test between every stage.
+
+## Options
+- --control-flow | --inject | --standalone | --signal-inputs | --recommended
+
+# angular-modernize
+
+Project Discovery must run first. Execute the workflow with the target arguments from the request.

package/templates/angular-skills/gemini/angular-page-from-api/SKILL.md

@@ -0,0 +1,24 @@
+---
+name: angular-page-from-api
+description: Generate an Angular page from a typed API method, deriving UI requirements from the API contract.
+---
+
+# /page-from-api
+
+Scaffold a page that matches the API capabilities.
+
+## Workflow
+1. Inspect the API method signature and return type (e.g. PagedResult<Order>).
+2. Derive likely UI requirements: list, loading, empty, error, pagination; filters/sorting only if the API supports them.
+3. Find the closest existing page pattern and reuse it.
+
+## Critical rule
+Never invent unsupported API functionality. If the API has no sort parameter, do not generate server-side sorting. If no delete endpoint, no Delete button.
+
+## Options
+- --like <page>      reference pattern
+- --crud             scaffold full CRUD (list/details/create/edit/delete) from a typed service
+
+# angular-page-from-api
+
+Project Discovery must run first. Execute the workflow with the target arguments from the request.

package/templates/angular-skills/gemini/angular-project-discovery/SKILL.md

@@ -0,0 +1,41 @@
+---
+name: angular-project-discovery
+description: Discover Angular project context before running Angular commands.
+---
+
+# Angular Project Discovery
+
+Before any Angular command, discover the repository context:
+
+- Angular version
+- Package manager
+- Standalone vs NgModule
+- Signals / RxJS usage
+- State-management libraries
+- Reactive Forms / Signal Forms
+- UI library: Material / PrimeNG / custom
+- Styling: SCSS / CSS / Tailwind / tokens
+- Testing: Vitest / Jest / Karma
+- Existing naming conventions
+- Existing folder architecture
+- Closest comparable implementation
+
+Never modernize code merely because the framework supports it — only when it fits the repository.
+
+## Commands
+- component-from : use an existing component as the reference
+- feature        : build a whole feature respecting existing architecture
+- clone-pattern  : clone any architectural pattern
+- design-match   : align a generated component with the design system
+- page-from-api  : scaffold a page from a typed API
+- form-from-model: build a form from a domain model
+- table-from-model: build a table with semantic columns
+- wire-api       : replace mock data with real API calls
+- signalize      : migrate state to Signals where appropriate
+- extract-component: extract a template region into a child component
+- split-component: decompose an oversized component
+- extract-store  : move state into a feature store
+- modernize      : orchestrate incremental migrations
+- responsive     : make a component responsive per project convention
+- generate-tests : write behavior-focused tests
+- fixtures       : generate model fixtures

package/templates/angular-skills/gemini/angular-responsive/SKILL.md

@@ -0,0 +1,22 @@
+---
+name: angular-responsive
+description: Make a component responsive following the existing project breakpoints and patterns.
+---
+
+# /responsive
+
+Responsive is not just media queries.
+
+## Workflow
+1. Discover project breakpoints, container widths, grid, mobile nav, table->card behavior, spacing/typography changes, dialog behavior.
+2. Analyze the target and transform fixed layouts (width: 900px; grid 400px 400px) per project conventions.
+3. Test important states: long translated text, empty, loading, validation errors, many actions, large values, small phone, tablet.
+
+## Options
+- --mobile | --tablet | --all
+- --like <page>      follow a reference responsive page
+- --visual           (future) iterate on rendered screenshots
+
+# angular-responsive
+
+Project Discovery must run first. Execute the workflow with the target arguments from the request.

package/templates/angular-skills/gemini/angular-signalize/SKILL.md

@@ -0,0 +1,21 @@
+---
+name: angular-signalize
+description: Refactor Angular component state to Signals where appropriate, deriving instead of synchronizing.
+---
+
+# /signalize
+
+Judiciously migrate toward Angular Signals.
+
+## Workflow
+1. Classify members: plain value, signal state, computed state, input signal, output, observable stream, resource, form state.
+2. Transform only what benefits: @Input -> input(), @Output -> output(), derived props -> computed(), async -> toSignal(), manual sync -> computed().
+3. Principle: derive instead of synchronize (replace set() effects with computed()).
+4. Keep RxJS where it is genuinely the right tool: websockets, router events, debouncing, retry, complex async orchestration.
+
+## Options
+- --inputs | --outputs | --state | --queries | --all
+
+# angular-signalize
+
+Project Discovery must run first. Execute the workflow with the target arguments from the request.

package/templates/angular-skills/gemini/angular-split-component/SKILL.md

@@ -0,0 +1,22 @@
+---
+name: angular-split-component
+description: Decompose an oversized component into focused components, controlling coupling and API surface.
+---
+
+# /split-component
+
+Refactor a large component (e.g. 1100+ lines) into focused parts.
+
+## Workflow
+1. Determine why it is large: many UI sections, too much state, business logic, data orchestration, forms.
+2. Choose a decomposition plan (presentational children + orchestrating container; extract a store if state is the issue).
+3. Aim for: cohesion HIGH, coupling LOW, API SMALL, testability IMPROVED.
+4. Avoid turning one large component into 14 tiny ones with 18 inputs / 11 outputs / 6 services.
+
+## Options
+- --plan            show decomposition plan only
+- --apply           execute the plan
+
+# angular-split-component
+
+Project Discovery must run first. Execute the workflow with the target arguments from the request.

package/templates/angular-skills/gemini/angular-table-from-model/SKILL.md

@@ -0,0 +1,23 @@
+---
+name: angular-table-from-model
+description: Generate an Angular data table from a model or API with semantic column selection and formatting.
+---
+
+# /table-from-model
+
+Produce a table that shows the right columns with correct formatting.
+
+## Workflow
+1. Select columns semantically: show identity, primary data, status, total, created; drop raw FKs/internal fields unless project patterns say otherwise.
+2. Detect formatting: status -> badge, total -> currency, createdAt -> date.
+3. Infer capabilities from the API: paged -> pagination, sort param -> sortable, filter object -> filters, search -> search.
+
+## Options
+- --actions <view,edit,delete>
+- --selectable | --filters | --pagination | --virtual
+- --responsive       follow project table->card transformation
+- --like <table>     reference table
+
+# angular-table-from-model
+
+Project Discovery must run first. Execute the workflow with the target arguments from the request.

package/templates/angular-skills/gemini/angular-wire-api/SKILL.md

@@ -0,0 +1,25 @@
+---
+name: angular-wire-api
+description: Replace static UI data with real API calls, choosing the dominant data-access pattern.
+---
+
+# /wire-api
+
+Wire a component to real data using the repository's dominant approach.
+
+## Workflow
+1. Derive UI requirements (collection, search, pagination, delete, refresh).
+2. Map service APIs onto those needs.
+3. Inspect existing patterns first: async pipe, toSignal, resource, feature store, NgRx, SignalStore, custom store.
+4. Choose the DOMINANT project pattern.
+5. Handle all states: initial, loading, loaded, empty, error, refreshing, mutation pending, mutation error.
+
+## Guardrail
+Do not wire unsupported actions. If the UI has Edit but the API has no update, report unresolved functionality instead of wiring.
+
+## Options
+- --preserve-mocks   keep mocks for Storybook/dev-mode
+
+# angular-wire-api
+
+Project Discovery must run first. Execute the workflow with the target arguments from the request.