Skip to content

Conversation

Copy link
Contributor

Copilot AI commented Nov 13, 2025

PR #88 added two features that were not documented: task frontmatter selectors and the -t flag for emitting task metadata.

Changes

Core Documentation

  • README.md: Added sections on task frontmatter selectors field and -t flag with examples
  • docs/reference/cli.md: Documented -t flag behavior and output format
  • docs/reference/file-formats.md: Documented selectors field syntax, array OR logic, and selector composition

How-to Guides

  • docs/how-to/create-tasks.md: Added embedded selectors examples and -t flag usage
  • docs/how-to/use-selectors.md: Added comprehensive section on task frontmatter selectors vs command-line selectors
  • examples/README.md: Updated with new example tasks

Examples

Added three tasks demonstrating the features:

  • implement-go-feature.md: Basic embedded selectors
  • write-tests.md: Stage-based filtering
  • refactor-code.md: Array selectors with OR logic

Example Usage

Task with embedded selectors:

---
task_name: implement-feature
selectors:
  language: go
  stage: implementation
---
# Implement Feature in Go

Automatically filters rules without -s flags:

# These are equivalent:
coding-context-cli implement-feature
coding-context-cli -s language=go -s stage=implementation implement-feature

View task metadata with -t:

coding-context-cli -t implement-feature

Output includes frontmatter:

---
task_name: implement-feature
selectors:
  language: go
  stage: implementation
---
# Task content...
Original prompt

Update the documentation to cover how to use recently added features.


💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.

Copilot AI and others added 2 commits November 13, 2025 16:34
- Add -t flag to README and CLI reference
- Document selectors field in task frontmatter
- Update file formats reference with selectors documentation
- Add examples showing task frontmatter selectors and -t flag
- Update how-to guide for creating tasks with embedded selectors

Co-authored-by: alexec <1142830+alexec@users.noreply.github.com>
- Add task frontmatter selectors section to use-selectors guide
- Document -t flag for viewing embedded selectors
- Update examples README with new task files
- Add examples showing array selectors and OR logic

Co-authored-by: alexec <1142830+alexec@users.noreply.github.com>
Copilot AI changed the title [WIP] Update documentation for recent features usage Document task frontmatter selectors and -t flag Nov 13, 2025
Copilot AI requested a review from alexec November 13, 2025 16:42
Copilot finished work on behalf of alexec November 13, 2025 16:42
@alexec alexec marked this pull request as ready for review November 13, 2025 16:43
@alexec alexec requested a review from swedishborgie November 13, 2025 16:44
@alexec
Copy link
Contributor

alexec commented Nov 13, 2025

@swedishborgie just FYI - update the docs.

@alexec alexec merged commit ec70ed5 into main Nov 13, 2025
1 check passed
@alexec alexec deleted the copilot/update-documentation-for-features branch November 13, 2025 16:44
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