Skip to content

Configure shared engineering skills for Claude and Codex - #21

Closed
aviyashchin wants to merge 2 commits into
mainfrom
agent/claude-387
Closed

aviyashchin wants to merge 2 commits into
mainfrom
agent/claude-387

Conversation

@aviyashchin

@aviyashchin aviyashchin commented Oct 1, 2026 •

Copy link
Copy Markdown
Contributor

Summary

Enable the engineering skills to use this repository's issue and domain rules from both Claude and Codex.

CLAUDE.md -> docs/agents/
                   issue-tracker.md
                   triage-labels.md
                   domain.md

The issue guide preserves required forms, issue types, approval and closure gates. The domain guide names existing sources: REPO-MAP.md, README.md.

Workflow: setup-matt-pocock-skills -> writing-for-agents -> deterministic configuration read-back -> repository gate. Refs market-ontology#387 — give each active repository one shared engineering-skill configuration.

Evidence

Before: the three repository setup files were absent.
After:

git diff --check HEAD^ HEAD
# exit 0
Configuration read-back: PASS (files, both harness pointers, preserved rules, domain sources, CLI contracts, scope).
GitHub label read-back: PASS (all five triage labels).
Documentation-only validation: git diff --check and configuration read-back. No application suite added.

Merge Danger

Door: two-way

Blast Radius: agent-guidance

Revert the configuration commit to remove the setup. Existing label definitions are retained. Application, deployment, credential and permission settings are unchanged.

RetriggerConfidence Score: 5/5

This documentation-only PR appears safe to merge.

Summary

This PR connects Claude and Codex to shared engineering guidance.

  • Agents can follow repository issue rules from the main guide.
  • Agents can organize multi-session work through GitHub maps and child issues.
  • Agents can match skill triage roles to the repository's issue labels.
  • Agents can find domain context through the repository's existing sources.

Diagram

%%{init: {'theme': 'neutral'}}%%
flowchart TD
  Claude[Claude] --> C[CLAUDE.md]
  Codex[Codex] --> A[AGENTS.md]
  A -->|existing symlink| C
  C --> I[docs/agents/issue-tracker.md]
  C --> T[docs/agents/triage-labels.md]
  C --> D[docs/agents/domain.md]
Loading

Reviews (2) · Last reviewed commit: "docs: share repository engineering-skill..." · Reviewed by Greptile

…t-ontology#387)

Add docs/agents/ (GitHub Issues tracker, triage labels, domain-doc layout)
and link it from the agent instructions, so wayfinder, to-spec, to-tickets
and afk publish maps, specs and tickets to this repository's issues.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@vercel

vercel Bot commented Oct 1, 2026 •

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
ghostshell Ready Ready Preview Oct 13, 2026 5:22pm UTC
ghostshell-runi Ready Ready Preview Oct 13, 2026 5:22pm UTC

greptile-apps[bot]
greptile-apps Bot previously approved these changes Oct 1, 2026
@aviyashchin

Copy link
Copy Markdown
Contributor Author

Closing without merging. The loop is rolling out first to the 10 most active repositories, which already have this setup (Subconscious-ai/market-ontology#387). Greptile also showed that the causl-kb template needs tailoring to this repository's issue rules and domain docs. When this repository adopts the loop, run /setup-matt-pocock-skills here so the configuration matches its own rules.

@aviyashchin aviyashchin closed this Oct 1, 2026
@aviyashchin
aviyashchin deleted the agent/claude-387 branch October 1, 2026 05:39
Refs Subconscious-ai/market-ontology#387. Uses setup-matt-pocock-skills and writing-for-agents; preserves existing issue forms, domain records and delivery gates.
@aviyashchin aviyashchin changed the title docs: configure Matt Pocock engineering skills Configure shared engineering skills for Claude and Codex Oct 13, 2026
@aviyashchin aviyashchin reopened this Oct 13, 2026
@aviyashchin
aviyashchin marked this pull request as draft October 13, 2026 17:21
@greptile-apps
greptile-apps Bot dismissed their stale review October 13, 2026 17:21

Dismissed because a newer commit was pushed; Greptile will re-review the current head.

@aviyashchin

Copy link
Copy Markdown
Contributor Author

Closing this draft to keep one owner for repository setup. Reusing #22 — share one engineering-skill configuration across Claude and Codex, which is merged. The parallel rollout was missed by this session's initial title search. No application or provider changes are included here.

This branch was successfully deployed

2 active deployments
Preview – ghostshell — 443865b9 Deployed Oct 13, 2026 by vercel[bot]
Preview – ghostshell-runi — 443865b9 Deployed Oct 13, 2026 by vercel[bot]
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.

1 participant