Commit Graph
17 Commits
Author SHA1 Message Date
gitadmin 1b5398afdc docs(setup-skills): add wayfinder operations and update skill references
- Add wayfinding operations section to all issue tracker backends (GitHub, GitLab, Gitea)
- Update skill names from `to-issues`/`to-prd` to `to-tickets`/`to-spec`
- Fix Gitea CLI reference from `gitea` to `tea`
- Fix ADR path from `adr` to `docs/adr`
- Fix various typos and whitespace issues in Gitea tracker docs
2026-07-09 12:51:58 -04:00
gitadmin c68f6b4267 docs: reorganize skill catalog structure and update descriptions
- Restructure skill listings across all README files
- Add new skills: agent-handoff, commit, tmux-launch-agent, lsp-code-analysis
- Move knowledge-gardener and agent-handoff to in-progress status
- Reassign skills between user-invoked and model-invoked categories
- Update descriptions to include OKF v0.1 conventions for conversation-summary and research-vault
- Remove empty productivity skill bucket
- Consolidate deprecated skill sections
2026-07-09 12:41:39 -04:00
gitadmin 1676528fad chore(skills): remove agent-cli configuration and fix minor typos
Remove `docs/agents/agent-cli.md` and all references to it from
`setup-skills/SKILL.md` (contents list, docs files list, and the
Agent CLI block template). Fix typo "languagee" → "language" in
`setup-skills/SKILL.md` and "labels" → "label" in
`implement-issue/SKILL.md`.
2026-07-06 15:09:56 -04:00
gitadmin c92ee69440 refactor: extract tmux-launch-agent from implement-issue/setup-skills, overhaul PKM skills
- New common/misc/tmux-launch-agent skill with detect-agent script
  and agents-seed.md (moved from engineering/setup-skills)
- implement-issue simplified: delegates agent dispatch to
  tmux-launch-agent instead of inlining it
- setup-skills stripped of Section E (agent CLI config)
- New in-progress/agent-handoff skill using tmux-launch-agent
- PKM skills simplified: conversation-summary and pkm-curation
  rewritten with leaner process, crit streamlined
- knowledge-gardener removed (moved to common/in-progress/)
- All READMEs updated to match
2026-07-06 11:29:16 -04:00
gitadmin 1614a0d469 removed all mattpocock skills. will use alternative repo 2026-07-05 17:33:49 -04:00
gitadmin a6b00a7f11 refactor(implement-issue): replace @{prompt} placeholder with {prompt} and remove deprecated --agent flag
Replace the `@{prompt}` placeholder with `{prompt}` across all skill docs and
agent-cli configs, remove the deprecated `--agent` flag from the invocation
syntax, delete the now-obsolete agent-cli test file, clarify that only one
triage label should be active at a time, and defer prompt-file cleanup to the
OS/child instead of removing it immediately after tmux launch.
2026-06-27 23:18:49 -04:00
gitadmin 032a842e82 Remove tea CLI dependency from implement-issue skill
Streamline the skill by removing tea-specific command examples. The
checks (issue exists, labels, blockers) still need to happen but
the exact commands are now at the discretion of the agent.

Also update agents-seed.md to fix arg configurations and add missing
notes about stdin piping.
2026-06-27 17:05:57 -04:00
gitadmin f9611e1343 feat(implement-issue): add Section E to setup-skills for agent CLI selection
- Add agents-seed.md as source of truth for supported agents
- Add Section E to setup-skills to present agent menu and validate binary on PATH
- Refactor implement-issue to read docs/agents/agent-cli.md instead of hardcoded table
- Remove detect-agent-linux.sh and detect-agent-macos.sh detection scripts
- Add mise/$SHELL -c runtime detection for agent dispatch
- Add invocation-time binary validation with clear error message
- Add test file documenting expected tmux command composition

Closes #9
2026-06-27 16:26:17 -04:00
gitadmin 8af5a20da5 docs(triage): add needs-review and in-progress labels
- Replace `in-review` with `needs-review` in implement-issue workflow
- Document `needs-review` and `in-progress` labels in triage labels table
- Sync label definitions across setup-skills and docs/agents
2026-06-26 14:00:55 -04:00
gitadmin dc9293c7be feat(implement-issue): make child agent dispatch agent-agnostic
- Add formal arg syntax: --agent, --base, --force
- Add process-tree detection scripts (Linux / macOS) to auto-detect parent agent
- Add dispatch table supporting pi, opencode, goose, codex, claude + unknown fallback
- Write child prompt to temp file instead of inline escaping
- Name tmux windows for discoverability
- Add new pre-flight checks: tmux session, agent detection, binary on PATH
2026-06-26 13:42:56 -04:00
gitadmin e6e322e542 feat: add implement-issue skill for dispatching child agents via worktree isolation (#7) 2026-06-26 11:39:21 -04:00
gitadmin cd40daec54 Fix README links, add missing skills, correct invocation classification
- Fixed 3 broken links in root and common READMEs (pkm-curation,
  forge-interaction, forge-preferences were pointing to wrong buckets)
- Moved project-context-pack from model-invoked to user-invoked
  (matches its disable-model-invocation: true flag)
- Added 8 missing user-invoked and 6 missing model-invoked skills
  to root and common READMEs
- Added all 9 engineering skills to engineering README
  (was missing codebase-design, domain-modeling, resolving-merge-conflicts,
  tdd, grill-with-docs, improve-codebase-architecture, setup-skills,
  to-issues, to-prd, triage)
- Added pkm-curation to pkm README
- Updated personal README to note both skills moved elsewhere
- Added all forge skills to deprecated README
- Added .gitignore for docs/adr/
- Added docs/agents/ reference files
- Added project context cache
2026-06-25 12:26:32 -04:00
gitadmin ff41e7965a refactor(forge): split forge-interaction into specialized GitHub and Gitea skills
Break the monolithic forge-interaction skill into focused, single-responsibility
skills for better predictability and maintainability:

- Add forge-github skill for GitHub-specific interactions using `gh` CLI
- Add forge-gitea skill for Gitea-specific interactions using `tea` CLI
- Convert forge-interaction into a router that delegates to specialized skills
- Add forge-router skill with model invocation disabled for guidance only
- Move all forge-related skills to common/deprecated directory

Each specialized skill now contains its own complete decision tree, CLI usage
patterns, and authentication checks for its respective forge platform.
2026-06-25 12:06:08 -04:00
gitadmin fbca2ada7e docs(project-context-pack): clarify procedure, tighten wording, add disable-model-invocation
- Rewrite step names and descriptions for clarity and conciseness
- Reorder navigation discipline and expand sensitive-file examples
- Add `disable-model-invocation: true` frontmatter flag
- Remove unused `date -Iseconds` command pattern
2026-06-25 12:05:01 -04:00
gitadmin 68f9b4691e feat(skills): add engineering skill definitions under common/engineering/ all from @mattpocock
Add 10 skill definitions covering codebase design, domain modeling,
test-driven development, triage, and development workflows:

- codebase-design: vocabulary and patterns for designing deep modules
- domain-modeling: build and sharpen project domain models
- grill-with-docs: interview-based design refinement with documentation
- improve-codebase-architecture: scan and report on deepening opportunities
- resolving-merge-conflicts: structured approach to merge/rebase conflicts
- setup-skills: per-repo configuration for engineering skills
- tdd: test-driven development workflow with vertical slices
- to-issues: break plans into tracer-bullet vertical slice issues
- to-prd: synthesize conversations into PRDs
- triage: state machine for issue/PR triage roles

Includes supporting files for ADR formats, issue tracker integrations
(GitHub, GitLab, Gitea), triage labels, and agent brief templates.
2026-06-25 12:01:55 -04:00
gitadmin 1a03d0a0ff feat(skills): add project-context-pack skill
Add a new engineering skill that creates or refreshes a bounded project
memory file to serve as a navigation map for repository exploration.

The skill follows a disciplined search procedure that:
- Uses fd/rg for inventory before broad file reads
- Classifies project type with evidence citations
- Reads selectively with per-file content caps
- Indexes via tree-sitter/LSP/rg before browsing source
- Caches results in .agent/project-context.md

References the skill in README.md, common/README.md, and
common/engineering/README.md.
2026-06-22 22:20:58 -04:00
gitadmin 041be56757 feat: initialize agent skills repository with three starter skills
Add project structure documentation (AGENTS.md) and initial README files
that organize skills by bucket and invocation type (user-invoked vs
model-invoked).

Introduce three skills:
- forge-interaction: GitHub/Gitea CLI automation for issues, PRs, releases
- forge-preferences: personal forge conventions (companion to forge-interaction)
- pkm-curation: Obsidian vault curation and note management

Include reference docs for vault conventions, agent integration, and the
invocation model that separates user-only from model-reachable skills.
2026-06-22 13:15:36 -04:00