Skip to content

feat(skills/agents): integrate sk harness quality gates across all workflow skills and agents#737

Merged
magicpro97 merged 3 commits into
mainfrom
feat/i735-i736-harness-skills-agents
May 30, 2026
Merged

feat(skills/agents): integrate sk harness quality gates across all workflow skills and agents#737
magicpro97 merged 3 commits into
mainfrom
feat/i735-i736-harness-skills-agents

Conversation

@magicpro97
Copy link
Copy Markdown
Owner

Summary

Addresses #735 and #736. Updates all core workflow skills and all agent files to integrate sk harness quality gates, enforce quality-over-speed, and ensure consistency across the AI toolchain.

Changes

Skills (Issue #735)

  • tentacle-orchestration/SKILL.md: Added Harness gate row to Phase 3 verification table + note to run sk harness check [--json] before Phase 4 when harness.yaml exists
  • task-step-generator/SKILL.md: Extended TEST phase template to include sk harness check when harness.yaml exists
  • project-onboarding/SKILL.md: Added step 0.4 Harness Engineeringsk harness init, verify harness.yaml, sk harness doctor
  • karpathy-guidelines/SKILL.md: Linked harness.yaml + sk harness check as the permanent mechanism for verifiable success criteria
  • workflow-creator/SKILL.md: Added HARNESS gate row to quality gate table example

Agents + Instructions (Issue #736)

  • All 10 .github/agents/*.agent.md: Appended ## Harness Integration section with sk harness check, SK_HARNESS=1, sk harness init --yes, quality-over-speed principle
  • .github/copilot-instructions.md: Added ## Harness Engineering section after Quality Checklist — 7-principle table with executable commands
  • AGENTS.md: Added Command column to the 🛡️ harness principles table

Why

The harness skill was created (PR #734) but the rest of the toolchain didn't reference it. Agents could rationalize skipping harness gates even though AGENTS.md has the principles. This PR ensures every skill that drives implementation and every agent contract explicitly names the harness commands.

Verification

  • No Python files changed — no test suite required
  • All markdown files are valid (no broken tables)
  • git diff --stat confirms surgical additions only

Linh Ngo and others added 2 commits May 30, 2026 23:14
…#735)

- tentacle-orchestration/SKILL.md: add Harness gate row to Phase 3
  verification table + note to run sk harness check before Phase 4
  when harness.yaml exists
- task-step-generator/SKILL.md: extend TEST phase template to include
  sk harness check when harness.yaml exists
- project-onboarding/SKILL.md: add step 0.4 Harness Engineering —
  sk harness init, verify harness.yaml, sk harness doctor
- karpathy-guidelines/SKILL.md: link harness.yaml + sk harness check
  as the permanent mechanism for verifiable success criteria
- workflow-creator/SKILL.md: add HARNESS gate row to gate table example

Closes #735

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
…copilot-instructions (#736)

- All 10 .github/agents/*.agent.md: append Harness Integration section
  with sk harness check, SK_HARNESS=1, sk harness init, quality-over-speed
- .github/copilot-instructions.md: add ## Harness Engineering section
  after Quality Checklist — 7-principle table with executable commands
- AGENTS.md: add Command column to harness principles table with
  sk harness init, SK_HARNESS=1, sk harness check, sk tentacle etc.

Closes #736

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Copilot AI review requested due to automatic review settings May 30, 2026 16:14
Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Wires the recently introduced sk harness capability (PR #734) into the workflow skills, agent contracts, and top-level instruction files so quality gates are explicitly named everywhere agents look for guidance. Documentation-only changes; no executable code is modified.

Changes:

  • Adds a Harness gate row / sk harness check reference to tentacle-orchestration, task-step-generator, karpathy-guidelines, and workflow-creator skills, and a new step 0.4 (Harness Engineering) plus new task-step-generator and workflow-creator skill files in project-onboarding.
  • Appends an identical ## Harness Integration section to all 10 .github/agents/*.agent.md files.
  • Adds a ## Harness Engineering table to .github/copilot-instructions.md and a Command column to the AGENTS.md harness-principles table.

Reviewed changes

Copilot reviewed 19 out of 19 changed files in this pull request and generated 1 comment.

Show a summary per file
File Description
AGENTS.md Adds a Command column to the 7-principle harness table (No-Ship-Bugs row has a missing python3).
.github/copilot-instructions.md New ## Harness Engineering section mirroring AGENTS.md with executable commands.
.github/skills/tentacle-orchestration/SKILL.md Adds Harness row to Phase 3 gate table and sk harness check note before Phase 4.
.github/skills/task-step-generator/SKILL.md New skill; TEST phase template includes sk harness check when harness.yaml exists.
.github/skills/task-step-generator/references/step-file-template.md New annotated step-file template.
.github/skills/project-onboarding/SKILL.md New skill including step 0.4 Harness Engineering.
.github/skills/karpathy-guidelines/SKILL.md New skill linking harness.yaml + sk harness check to verifiable success criteria.
.github/skills/workflow-creator/SKILL.md New skill; example gate table includes a HARNESS row.
.github/skills/workflow-creator/references/workflow-template.md New WORKFLOW.md template.
.github/agents/*.agent.md (10 files) Each appends the same ## Harness Integration section.

Comment thread AGENTS.md Outdated
| 7 | **Knowledge-Recording** | `sk learn` after every bug fix or new pattern. | <!-- AI: call sk learn --mistake or --pattern before task_complete --> |
| # | Principle | Rule | Command | <!-- AI: enforcement note --> |
|---|-----------|------|---------|-------------------------------|
| 1 | **No-Ship-Bugs** | CODE→COMPILE→TEST→VERIFY→COMMIT. Never commit without passing tests. | `python3 test_security.py && test_fixes.py` | <!-- AI: run test_security.py && test_fixes.py before any commit --> |
Copy link
Copy Markdown
Owner Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Fixed in f70c19d — changed python3 test_security.py && test_fixes.py to python3 test_security.py && python3 test_fixes.py in AGENTS.md.

… table

Address reviewer comment: 'test_fixes.py' without python3 would try to
execute as a shell command and fail. Use explicit 'python3 test_fixes.py'.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@magicpro97 magicpro97 requested a review from Copilot May 30, 2026 16:53
@magicpro97 magicpro97 merged commit 412410c into main May 30, 2026
34 of 35 checks passed
@magicpro97 magicpro97 deleted the feat/i735-i736-harness-skills-agents branch May 30, 2026 16:56
Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot encountered an error and was unable to review this pull request. You can try again by re-requesting a review.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants