@harness-engineering/cli 1.2.0 → 1.2.2

package/dist/agents/commands/claude-code/harness/planning.md

@@ -1,41 +0,0 @@
-## <!-- Generated by harness generate-slash-commands. Do not edit. -->
-
-name: harness:planning
-description: Structured project planning with harness constraints and validation
-argument-hint: "[--path <path>]"
-allowed-tools:
-
-- Bash
-- Read
-- Write
-- Edit
-- Glob
-
----
-
-<context>
-Cognitive mode: constructive-architect
-Type: rigid
-</context>
-
-<objective>
-Structured project planning with harness constraints and validation
-
-Phases:
-
-- scope: Define goals and constraints
-- decompose: Break work into tasks
-- sequence: Order tasks and identify dependencies
-- validate: Run harness checks on the plan
-  </objective>
-
-<execution_context>
-@agents/skills/claude-code/harness-planning/SKILL.md
-@agents/skills/claude-code/harness-planning/skill.yaml
-</execution_context>
-
-<process>
-1. Try: invoke mcp__harness__run_skill with skill: "harness-planning"
-2. If MCP unavailable: read SKILL.md and follow its workflow directly
-3. Pass through any arguments provided by the user
-</process>

package/dist/agents/commands/claude-code/harness/pre-commit-review.md

@@ -1,38 +0,0 @@
-## <!-- Generated by harness generate-slash-commands. Do not edit. -->
-
-name: harness:pre-commit-review
-description: Lightweight pre-commit quality gate combining mechanical checks and AI review
-argument-hint: "[--path <path>]"
-allowed-tools:
-
-- Bash
-- Read
-- Glob
-- Grep
-
----
-
-<context>
-Type: rigid
-</context>
-
-<objective>
-Lightweight pre-commit quality gate combining mechanical checks and AI review
-
-Phases:
-
-- mechanical-checks: Run deterministic checks (lint, typecheck, tests)
-- classify-changes: Determine if AI review is needed based on change type
-- ai-review: Lightweight AI review of staged changes (skipped for docs/config-only) (optional)
-  </objective>
-
-<execution_context>
-@agents/skills/claude-code/harness-pre-commit-review/SKILL.md
-@agents/skills/claude-code/harness-pre-commit-review/skill.yaml
-</execution_context>
-
-<process>
-1. Try: invoke mcp__harness__run_skill with skill: "harness-pre-commit-review"
-2. If MCP unavailable: read SKILL.md and follow its workflow directly
-3. Pass through any arguments provided by the user
-</process>

package/dist/agents/commands/claude-code/harness/refactoring.md

@@ -1,35 +0,0 @@
-## <!-- Generated by harness generate-slash-commands. Do not edit. -->
-
-name: harness:refactoring
-description: Safe refactoring with validation before and after changes
-argument-hint: "[--path <path>]"
-allowed-tools:
-
-- Bash
-- Read
-- Write
-- Edit
-- Glob
-- Grep
-
----
-
-<context>
-Cognitive mode: meticulous-implementer
-Type: flexible
-</context>
-
-<objective>
-Safe refactoring with validation before and after changes
-</objective>
-
-<execution_context>
-@agents/skills/claude-code/harness-refactoring/SKILL.md
-@agents/skills/claude-code/harness-refactoring/skill.yaml
-</execution_context>
-
-<process>
-1. Try: invoke mcp__harness__run_skill with skill: "harness-refactoring"
-2. If MCP unavailable: read SKILL.md and follow its workflow directly
-3. Pass through any arguments provided by the user
-</process>

package/dist/agents/commands/claude-code/harness/skill-authoring.md

@@ -1,35 +0,0 @@
-## <!-- Generated by harness generate-slash-commands. Do not edit. -->
-
-name: harness:skill-authoring
-description: Create and maintain harness skills following the rich skill format
-argument-hint: "[--path <path>]"
-allowed-tools:
-
-- Bash
-- Read
-- Write
-- Edit
-- Glob
-- Grep
-
----
-
-<context>
-Cognitive mode: constructive-architect
-Type: flexible
-</context>
-
-<objective>
-Create and maintain harness skills following the rich skill format
-</objective>
-
-<execution_context>
-@agents/skills/claude-code/harness-skill-authoring/SKILL.md
-@agents/skills/claude-code/harness-skill-authoring/skill.yaml
-</execution_context>
-
-<process>
-1. Try: invoke mcp__harness__run_skill with skill: "harness-skill-authoring"
-2. If MCP unavailable: read SKILL.md and follow its workflow directly
-3. Pass through any arguments provided by the user
-</process>

package/dist/agents/commands/claude-code/harness/state-management.md

@@ -1,35 +0,0 @@
-## <!-- Generated by harness generate-slash-commands. Do not edit. -->
-
-name: harness:state-management
-description: Manage persistent session state across harness agent sessions
-argument-hint: "[--path <path>]"
-allowed-tools:
-
-- Bash
-- Read
-- Write
-- Edit
-- Glob
-
----
-
-<context>
-Cognitive mode: meticulous-implementer
-Type: flexible
-State: persistent (files: .harness/state.json)
-</context>
-
-<objective>
-Manage persistent session state across harness agent sessions
-</objective>
-
-<execution_context>
-@agents/skills/claude-code/harness-state-management/SKILL.md
-@agents/skills/claude-code/harness-state-management/skill.yaml
-</execution_context>
-
-<process>
-1. Try: invoke mcp__harness__run_skill with skill: "harness-state-management"
-2. If MCP unavailable: read SKILL.md and follow its workflow directly
-3. Pass through any arguments provided by the user
-</process>

package/dist/agents/commands/claude-code/harness/tdd.md

@@ -1,42 +0,0 @@
-## <!-- Generated by harness generate-slash-commands. Do not edit. -->
-
-name: harness:tdd
-description: Test-driven development integrated with harness validation
-argument-hint: "[--path <path>]"
-allowed-tools:
-
-- Bash
-- Read
-- Write
-- Edit
-- Glob
-- Grep
-
----
-
-<context>
-Cognitive mode: meticulous-implementer
-Type: rigid
-</context>
-
-<objective>
-Test-driven development integrated with harness validation
-
-Phases:
-
-- red: Write failing test
-- green: Implement minimal code to pass
-- refactor: Clean up while keeping tests green (optional)
-- validate: Run harness checks
-  </objective>
-
-<execution_context>
-@agents/skills/claude-code/harness-tdd/SKILL.md
-@agents/skills/claude-code/harness-tdd/skill.yaml
-</execution_context>
-
-<process>
-1. Try: invoke mcp__harness__run_skill with skill: "harness-tdd"
-2. If MCP unavailable: read SKILL.md and follow its workflow directly
-3. Pass through any arguments provided by the user
-</process>

package/dist/agents/commands/claude-code/harness/validate-context-engineering.md

@@ -1,32 +0,0 @@
-## <!-- Generated by harness generate-slash-commands. Do not edit. -->
-
-name: harness:validate-context-engineering
-description: Validate repository context engineering practices (AGENTS.md, doc coverage, knowledge map)
-argument-hint: "[--path <path>]"
-allowed-tools:
-
-- Bash
-- Read
-- Glob
-
----
-
-<context>
-Cognitive mode: meticulous-verifier
-Type: flexible
-</context>
-
-<objective>
-Validate repository context engineering practices (AGENTS.md, doc coverage, knowledge map)
-</objective>
-
-<execution_context>
-@agents/skills/claude-code/validate-context-engineering/SKILL.md
-@agents/skills/claude-code/validate-context-engineering/skill.yaml
-</execution_context>
-
-<process>
-1. Try: invoke mcp__harness__run_skill with skill: "validate-context-engineering"
-2. If MCP unavailable: read SKILL.md and follow its workflow directly
-3. Pass through any arguments provided by the user
-</process>

package/dist/agents/commands/claude-code/harness/verification.md

@@ -1,38 +0,0 @@
-## <!-- Generated by harness generate-slash-commands. Do not edit. -->
-
-name: harness:verification
-description: Comprehensive harness verification of project health and compliance
-argument-hint: "[--path <path>]"
-allowed-tools:
-
-- Bash
-- Read
-- Glob
-
----
-
-<context>
-Cognitive mode: meticulous-verifier
-Type: rigid
-</context>
-
-<objective>
-Comprehensive harness verification of project health and compliance
-
-Phases:
-
-- check: Run all harness validation commands
-- report: Summarize findings and violations
-- remediate: Fix any critical violations
-  </objective>
-
-<execution_context>
-@agents/skills/claude-code/harness-verification/SKILL.md
-@agents/skills/claude-code/harness-verification/skill.yaml
-</execution_context>
-
-<process>
-1. Try: invoke mcp__harness__run_skill with skill: "harness-verification"
-2. If MCP unavailable: read SKILL.md and follow its workflow directly
-3. Pass through any arguments provided by the user
-</process>

package/dist/agents/commands/gemini-cli/harness/add-component.toml

@@ -1,240 +0,0 @@
-# Generated by harness generate-slash-commands. Do not edit.
-description = "Add a component to an existing harness project"
-prompt = """
-<context>
-Cognitive mode: constructive-architect
-Type: flexible
-</context>
-
-<objective>
-Add a component to an existing harness project
-</objective>
-
-<execution_context>
---- SKILL.md (agents/skills/claude-code/add-harness-component/SKILL.md) ---
-# Add Harness Component
-
-> Add layers, documentation, components, or skills to an existing harness project with proper integration. Validate against existing constraints, wire into architecture, and verify the result.
-
-## When to Use
-
-- Adding a new layer to the project's architecture
-- Adding a new documentation file that harness should track
-- Adding a new component (module, service, package) that must be wired into existing layer boundaries
-- Adding a new skill to the project's skill library
-- When a plan calls for introducing a new architectural boundary or module
-- NOT when initializing a project from scratch (use initialize-harness-project)
-- NOT when modifying an existing component (use standard editing workflows)
-- NOT when removing components (manual process — removing requires careful dependency analysis)
-
-## Process
-
-### Phase 1: DETERMINE — Identify What to Add
-
-1. **Clarify the component type.** Ask if not obvious from context:
-   - **Layer:** A new architectural boundary (e.g., adding an "infrastructure" layer to a project that only has "business" and "data")
-   - **Document:** A documentation file that harness should track for drift detection (e.g., API docs, architecture decision records)
-   - **Component:** A code module, service, or package that lives within an existing layer
-   - **Skill:** A new harness skill definition for the project's workflow
-
-2. **Gather requirements.** For each type:
-   - **Layer:** Name, which directories belong to it, which layers it can import from, which layers can import from it
-   - **Document:** Path, what it documents, which code files it relates to
-   - **Component:** Name, which layer it belongs to, what it depends on, what will depend on it
-   - **Skill:** Name, purpose, type (rigid or flexible), triggers
-
-3. **Check prerequisites.** The project must already be initialized with harness. If `harness.yaml` does not exist, stop and run initialize-harness-project first.
-
-### Phase 2: VALIDATE — Check Against Existing Constraints
-
-1. **Read the current configuration.** Load `harness.yaml` and `AGENTS.md` to understand existing layers, constraints, and architecture.
-
-2. **Verify the new component does not conflict:**
-   - Does the layer name already exist?
-   - Does the component directory already exist?
-   - Would the new dependency relationships create circular imports?
-   - Does the component violate any existing forbidden-import rules?
-
-3. **If conflicts are found,** report them clearly: "Adding layer X would conflict with existing layer Y because [reason]. Options: [A] rename, [B] merge into existing layer, [C] restructure. Which do you prefer?"
-
-4. **Run `harness check-deps`** on the current state to establish a clean baseline. If it already fails, fix existing violations before adding new components.
-
-### Phase 3: ADD — Create the Component
-
-1. **Run `harness add` with appropriate arguments:**
-   - Layer: `harness add layer <name> --dirs <dir1,dir2> --imports <allowed-layers>`
-   - Document: `harness add doc <path> --tracks <related-code-paths>`
-   - Component: `harness add component <name> --layer <layer-name>`
-   - Skill: `harness add skill <name> --type <rigid|flexible>`
-
-2. **Review generated files and configuration changes.** `harness add` modifies `harness.yaml` and may generate template files. Check that the changes look correct.
-
-3. **Create the actual code or content.** `harness add` creates the configuration entry but not necessarily the implementation. Create the directories, files, and initial code as needed.
-
-### Phase 4: WIRE — Integrate into Architecture
-
-1. **Update imports and exports.** If the new component needs to be imported by existing code, add the imports. If existing code needs to be aware of the new layer, update barrel files or index modules.
-
-2. **Update `AGENTS.md`.** Add the new component to the architecture section. Document its purpose, boundaries, and relationships to other components. This keeps agent instructions accurate.
-
-3. **Update layer configuration** if the new component changes dependency relationships. Ensure `harness.yaml` reflects the actual import graph.
-
-4. **For new skills:** Write the `skill.yaml` and `SKILL.md` files following the harness skill format. Use harness-skill-authoring for guidance on writing good skill content.
-
-### Phase 5: VERIFY — Confirm Integration
-
-1. **Run `harness validate`** to verify the full project configuration is still valid after the addition.
-
-2. **Run `harness check-deps`** to verify no dependency violations were introduced. The new component's imports must respect layer boundaries.
-
-3. **If validation fails,** fix the issues before committing. Common causes:
-   - New layer not properly registered in `harness.yaml`
-   - Component placed in wrong directory for its declared layer
-   - Imports from forbidden layers
-   - `AGENTS.md` references outdated architecture
-
-4. **Commit the addition.** All new and modified files in a single atomic commit.
-
-## Harness Integration
-
-- **`harness add layer <name>`** — Register a new architectural layer with directory mappings and import rules.
-- **`harness add doc <path>`** — Register a documentation file for drift tracking.
-- **`harness add component <name> --layer <layer>`** — Register a new code component within an existing layer.
-- **`harness add skill <name> --type <type>`** — Scaffold a new skill definition.
-- **`harness validate`** — Verify project configuration after the addition.
-- **`harness check-deps`** — Verify dependency constraints are respected after the addition.
-
-## Success Criteria
-
-- The new component is properly registered in `harness.yaml`
-- The component's files exist in the correct directories for its declared layer
-- `AGENTS.md` is updated to reflect the new component
-- `harness validate` passes after the addition
-- `harness check-deps` passes after the addition (no new violations)
-- No circular dependencies were introduced
-- The addition is committed as a single atomic commit
-
-## Examples
-
-### Example: Adding a New Layer
-
-```
-Human: "We need an infrastructure layer for external API clients."
-
-DETERMINE: Adding a layer. Name: infrastructure. Dirs: src/infrastructure/.
-  Imports from: (none — infrastructure is a leaf layer, no internal dependencies).
-  Imported by: business layer (services call external APIs through infrastructure).
-
-VALIDATE:
-  Read harness.yaml — existing layers: presentation, business, data.
-  No conflict with "infrastructure" name.
-  Run: harness check-deps — passes (clean baseline).
-
-ADD:
-  harness add layer infrastructure --dirs src/infrastructure --imports none
-  mkdir -p src/infrastructure
-
-WIRE:
-  Update harness.yaml: allow business → infrastructure imports.
-  Update AGENTS.md: document infrastructure layer purpose and boundaries.
-
-VERIFY:
-  harness validate    # Pass
-  harness check-deps  # Pass
-  git add harness.yaml AGENTS.md src/infrastructure/
-  git commit -m "feat: add infrastructure layer for external API clients"
-```
-
-### Example: Adding a Document for Drift Tracking
-
-```
-Human: "Track our API specification for documentation drift."
-
-DETERMINE: Adding a document. Path: docs/api-spec.md.
-  Tracks: src/routes/, src/models/response.ts.
-
-ADD:
-  harness add doc docs/api-spec.md --tracks src/routes,src/models/response.ts
-
-WIRE:
-  Update AGENTS.md: note that docs/api-spec.md is tracked for drift.
-
-VERIFY:
-  harness validate  # Pass
-  git add harness.yaml AGENTS.md
-  git commit -m "feat: track API spec for documentation drift detection"
-```
-
-### Example: Adding a Component to an Existing Layer
-
-```
-Human: "Add a notification service to the business layer."
-
-DETERMINE: Adding a component. Name: notification-service. Layer: business.
-  Depends on: data layer (notification repository). Depended on by: presentation layer (routes).
-
-VALIDATE:
-  Read harness.yaml — business layer exists, maps to src/services/.
-  No existing notification-service directory.
-  business → data is an allowed import. Presentation → business is allowed.
-  Run: harness check-deps — passes.
-
-ADD:
-  harness add component notification-service --layer business
-  Create src/services/notification-service.ts
-  Create src/services/notification-service.test.ts
-
-WIRE:
-  Add export to src/services/index.ts (if barrel file exists).
-  Update AGENTS.md: add notification service to business layer component list.
-
-VERIFY:
-  harness validate    # Pass
-  harness check-deps  # Pass
-  git add harness.yaml AGENTS.md src/services/notification-service.*
-  git commit -m "feat: add notification service to business layer"
-```
-
-
---- skill.yaml (agents/skills/claude-code/add-harness-component/skill.yaml) ---
-name: add-harness-component
-version: "1.0.0"
-description: Add a component to an existing harness project
-cognitive_mode: constructive-architect
-triggers:
-  - manual
-platforms:
-  - claude-code
-  - gemini-cli
-tools:
-  - Bash
-  - Read
-  - Write
-  - Edit
-  - Glob
-cli:
-  command: harness skill run add-harness-component
-  args:
-    - name: path
-      description: Project root path
-      required: false
-mcp:
-  tool: run_skill
-  input:
-    skill: add-harness-component
-    path: string
-type: flexible
-state:
-  persistent: false
-  files: []
-depends_on:
-  - initialize-harness-project
-
-</execution_context>
-
-<process>
-1. Try: invoke mcp__harness__run_skill with skill: "add-harness-component"
-2. If MCP unavailable: follow the SKILL.md workflow provided above directly
-3. Pass through any arguments provided by the user
-</process>
-"""