Skip to content

[feat] Doc backfill, ticket-context DRY, Python language skill#67

Merged
lugassawan merged 4 commits intomainfrom
feat/doc-python-skill
May 2, 2026
Merged

[feat] Doc backfill, ticket-context DRY, Python language skill#67
lugassawan merged 4 commits intomainfrom
feat/doc-python-skill

Conversation

@lugassawan
Copy link
Copy Markdown
Owner

Summary

  • Backfill README + docs/catalog.md for /capture, /cleanup-merged, and product-manager subagent — shipped in [feat] Add /capture command and product-manager persona for portable issue capture #66 but never reflected in the contributor-facing docs
  • Add missing argument-hint frontmatter to commands/review.md and commands/security-review.md
  • DRY the ticket-context prelude in 5 commands (debug, implement, design, refactor, test) — each inlined the full trigger-pattern list; replaced with a one-liner that defers to the canonical "When to invoke" section in skills/ticket-context/SKILL.md
  • Add skills/language-python/SKILL.md covering type hints, errors, context managers, generators, asyncio/GIL concurrency, pattern matching, packaging (uv/poetry/pyproject.toml), pytest, and performance

Test Plan

  • Changed skills/commands/agents load without errors
  • bash scripts/validate.sh passes (All checks passed)
  • grep capture\|cleanup-merged\|product-manager README.md docs/catalog.md — all 3 items confirmed present
  • grep language-python README.md docs/catalog.md — Python in both Languages surfaces

Closes #8

lugassawan added 4 commits May 2, 2026 18:47
…t-manager

- Add /capture and /cleanup-merged to README commands list
- Add product-manager to README subagents list
- Add /capture row to catalog.md Commands table
- Add product-manager row to catalog.md Subagents table
- Add argument-hint frontmatter to review and security-review commands
Each command previously inlined the full trigger-pattern list (Jira keys,
Atlassian/Confluence URLs, GitHub refs). Those patterns are already the
canonical source of truth in skills/ticket-context/SKILL.md "When to invoke".

Replace with a short invocation line that references the skill, eliminating
the copy-paste surface that drifts when detection rules change.
Adds skills/language-python/SKILL.md covering:
- Type hints and dataclasses (PEP 484, Protocol, TypedDict)
- Error handling idioms
- Context managers and generators
- Concurrency: GIL caveat, asyncio TaskGroup, ProcessPoolExecutor
- Pattern matching (3.10+)
- Packaging: pyproject.toml, uv/poetry, virtualenvs
- Testing: pytest, parametrize, pytest-asyncio
- Performance: cProfile, py-spy, C extension guidance
- Avoid section

Also updates README and docs/catalog.md with Python in the Languages table.
… examples

- commands/debug.md: strip inline trigger-pattern examples from parenthetical
  to match the other four DRY'd commands and prevent future drift
- skills/language-python/SKILL.md: add @contextlib.contextmanager code example
  to Context managers section (matches peer skills' example-per-section style)
- skills/language-python/SKILL.md: annotate walrus operator usage with # 3.8+
  for consistency with the file's version-annotation convention
@lugassawan lugassawan merged commit 7d3d676 into main May 2, 2026
3 checks passed
@lugassawan lugassawan deleted the feat/doc-python-skill branch May 2, 2026 12:05
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.

[feat] Add Python language skill

1 participant