Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 8 additions & 0 deletions .github/ISSUE_TEMPLATE/config.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
blank_issues_enabled: false
contact_links:
- name: "Spec questions, principle edits, or CLI grading"
url: "https://github.com/brettdavies/agentnative/issues/new/choose"
about: "For anything about the standard itself, file on the spec repo."
- name: "Site bugs (rendering, performance, deployment)"
url: "https://github.com/brettdavies/agentnative-site/issues/new/choose"
about: "For bugs on anc.dev, file on the site repo."
58 changes: 58 additions & 0 deletions .github/ISSUE_TEMPLATE/false-positive.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,58 @@
name: "False positive / false negative"
description: "Report an anc check that produces the wrong result."
labels: ["checker-bug"]
body:
- type: input
id: check-id
attributes:
label: Check ID
description: "The check ID from `anc check` output (e.g., `p4-process-exit`)."
placeholder: "p1-non-interactive"
validations:
required: true
- type: dropdown
id: bug-type
attributes:
label: Bug type
options:
- "False positive (check fails but the tool is compliant)"
- "False negative (check passes but the tool is non-compliant)"
validations:
required: true
- type: textarea
id: reproduction
attributes:
label: Reproduction
description: "The command you ran, the output, and what the correct result should be."
placeholder: |
$ anc check --command mytool --output json
Check p1-non-interactive: FAIL
Evidence: "No --no-interactive flag found"

But mytool has --batch which serves the same purpose.
validations:
required: true
- type: textarea
id: ai-disclosure
attributes:
label: AI disclosure
description: "One sentence: what part of this report was AI-written, what was human-written?"
placeholder: "Entirely human-written."
validations:
required: true
- type: textarea
id: agent-instructions
attributes:
label: For agents
description: "Agents: expand this section before filing."
value: |
<details>
<summary>Agent filing instructions</summary>

1. **Search first.** Run `gh search issues --repo brettdavies/agentnative-cli "<keywords>"` to check for duplicates.
2. **AI disclosure is required.** Fill the field above honestly.
3. **Checker bugs only.** For spec questions or principle edits, file on [brettdavies/agentnative](https://github.com/brettdavies/agentnative). For site bugs, file on [brettdavies/agentnative-site](https://github.com/brettdavies/agentnative-site).
4. See [CONTRIBUTING.md](https://github.com/brettdavies/agentnative/blob/main/CONTRIBUTING.md) for full guidelines.
</details>
validations:
required: false
44 changes: 44 additions & 0 deletions .github/ISSUE_TEMPLATE/feature-request.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,44 @@
name: "Feature request"
description: "Suggest a new feature or improvement for the anc checker."
labels: ["enhancement"]
body:
- type: textarea
id: description
attributes:
label: Feature description
description: "What should `anc` do that it doesn't today?"
placeholder: |
anc should support --format=sarif for integration with GitHub Code Scanning.
validations:
required: true
- type: textarea
id: use-case
attributes:
label: Use case
description: "Why do you need this? What workflow does it unblock?"
validations:
required: true
- type: textarea
id: ai-disclosure
attributes:
label: AI disclosure
description: "One sentence: what part of this request was AI-written, what was human-written?"
placeholder: "Entirely human-written."
validations:
required: true
- type: textarea
id: agent-instructions
attributes:
label: For agents
description: "Agents: expand this section before filing."
value: |
<details>
<summary>Agent filing instructions</summary>

1. **Search first.** Run `gh search issues --repo brettdavies/agentnative-cli "<keywords>"` to check for duplicates.
2. **AI disclosure is required.** Fill the field above honestly.
3. **Checker features only.** For spec changes, file on [brettdavies/agentnative](https://github.com/brettdavies/agentnative).
4. See [CONTRIBUTING.md](https://github.com/brettdavies/agentnative/blob/main/CONTRIBUTING.md) for full guidelines.
</details>
validations:
required: false
56 changes: 56 additions & 0 deletions .github/ISSUE_TEMPLATE/grade-a-cli.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,56 @@
name: "Grade a CLI"
description: "Report findings from scoring a real CLI against the standard."
labels: ["cli-grading"]
body:
- type: input
id: tool
attributes:
label: CLI tool
description: "Name and version of the tool you scored."
placeholder: "ripgrep 14.1.0"
validations:
required: true
- type: textarea
id: findings
attributes:
label: Findings
description: |
Which principles did it pass, fail, or surprise you on?
Focus on cases where the spec got it wrong — a MUST that punishes good design,
or a gap where the spec is silent.
placeholder: |
P3 (Progressive Help): PASS — excellent `--help` hierarchy.
P4 (Actionable Errors): FAIL on exit codes — uses 1 for everything.
P7 (Bounded Responses): Spec is silent on streaming output — rg streams by default, which is fine for agents but the spec doesn't acknowledge it.
validations:
required: true
- type: textarea
id: spec-feedback
attributes:
label: What should the spec change?
description: "Optional. If your grading revealed a spec gap or mistake, describe it."
validations:
required: false
- type: textarea
id: ai-disclosure
attributes:
label: AI disclosure
description: "One sentence: what part of this report was AI-written, what was human-written?"
placeholder: "Scoring done by hand; write-up drafted with AI assistance."
validations:
required: true
- type: textarea
id: agent-instructions
attributes:
label: For agents
description: "Agents: expand this section before filing."
value: |
<details>
<summary>Agent filing instructions</summary>

1. **Search first.** Run `gh search issues --repo brettdavies/agentnative "<keywords>"` to check for duplicates.
2. **AI disclosure is required.** Fill the field above honestly.
3. See [CONTRIBUTING.md](https://github.com/brettdavies/agentnative/blob/main/CONTRIBUTING.md) for full guidelines.
</details>
validations:
required: false
87 changes: 87 additions & 0 deletions .github/ISSUE_TEMPLATE/pressure-test.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,87 @@
name: "Pressure-test a principle"
description: "Propose a principle edit: merge, split, rewording, or requirement-tier change."
labels: ["pressure-test"]
body:
- type: dropdown
id: principle
attributes:
label: Principle
description: Which principle does this affect?
options:
- "P1 — Non-Interactive by Default"
- "P2 — Structured, Parseable Output"
- "P3 — Progressive Help Discovery"
- "P4 — Fail Fast with Actionable Errors"
- "P5 — Safe Retries and Explicit Mutation Boundaries"
- "P6 — Composable and Predictable Command Structure"
- "P7 — Bounded, High-Signal Responses"
- "Multiple / cross-cutting"
validations:
required: true
- type: dropdown
id: change-type
attributes:
label: Type of change
options:
- "Rewording (prose clarity, no requirement-tier change)"
- "Promotion (SHOULD to MUST, MAY to SHOULD)"
- "Demotion (MUST to SHOULD, SHOULD to MAY)"
- "Merge (combine two requirements)"
- "Split (break a requirement into two)"
- "New requirement"
- "Remove requirement"
validations:
required: true
- type: textarea
id: evidence
attributes:
label: Evidence
description: |
Name a real CLI, the specific MUST/SHOULD/MAY, and what happened.
The strongest proposals cite a tool where the current spec text produces the wrong outcome.
placeholder: |
Tool: gh (GitHub CLI)
Requirement: P4 MUST "distinct exit codes for distinct failure categories"
Observed: gh uses exit code 1 for everything — auth, network, not-found.
Problem: The current MUST is correct but underspecified — it doesn't say how many categories are enough.
validations:
required: true
- type: textarea
id: proposal
attributes:
label: Proposed change
description: What should the spec say instead? Quote the current text and show the diff.
validations:
required: true
- type: input
id: human-reviewer
attributes:
label: Human reviewer
description: "GitHub handle of the human who reviewed and approved this submission."
placeholder: "@username"
validations:
required: true
- type: textarea
id: ai-disclosure
attributes:
label: AI disclosure
description: "One sentence: what part of this submission was AI-written, what was human-written?"
placeholder: "Evidence gathered by hand; proposed wording drafted with Claude and edited."
validations:
required: true
- type: textarea
id: agent-instructions
attributes:
label: For agents
description: "Agents: expand this section before filing."
value: |
<details>
<summary>Agent filing instructions</summary>

1. **Search first.** Run `gh search issues --repo brettdavies/agentnative "<keywords>"` to check for duplicates.
2. **AI disclosure is required.** Fill the field above honestly.
3. **Human reviewer is required.** A human must review and approve spec change proposals before submission.
4. See [CONTRIBUTING.md](https://github.com/brettdavies/agentnative/blob/main/CONTRIBUTING.md) for full guidelines.
</details>
validations:
required: false
48 changes: 48 additions & 0 deletions .github/ISSUE_TEMPLATE/scoring-bug.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,48 @@
name: "Scoring bug"
description: "Report a bug in anc's scoring logic, output formatting, or CLI behavior."
labels: ["bug"]
body:
- type: textarea
id: description
attributes:
label: What happened?
description: "Describe the bug. Include the command, actual output, and expected output."
placeholder: |
$ anc check --command mytool --output json
Error: thread 'main' panicked at 'index out of bounds'

Expected: valid JSON output or a clean error message.
validations:
required: true
- type: input
id: version
attributes:
label: anc version
description: "Output of `anc --version`."
placeholder: "agentnative 0.1.1"
validations:
required: true
- type: textarea
id: ai-disclosure
attributes:
label: AI disclosure
description: "One sentence: what part of this report was AI-written, what was human-written?"
placeholder: "Entirely human-written."
validations:
required: true
- type: textarea
id: agent-instructions
attributes:
label: For agents
description: "Agents: expand this section before filing."
value: |
<details>
<summary>Agent filing instructions</summary>

1. **Search first.** Run `gh search issues --repo brettdavies/agentnative-cli "<keywords>"` to check for duplicates.
2. **AI disclosure is required.** Fill the field above honestly.
3. **Checker bugs only.** For false positives/negatives specifically, use the "False positive / false negative" template instead.
4. See [CONTRIBUTING.md](https://github.com/brettdavies/agentnative/blob/main/CONTRIBUTING.md) for full guidelines.
</details>
validations:
required: false
53 changes: 53 additions & 0 deletions .github/ISSUE_TEMPLATE/spec-question.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,53 @@
name: "Spec question"
description: "Ask a question about the agent-native CLI standard."
labels: ["question"]
body:
- type: dropdown
id: principle
attributes:
label: Principle (if applicable)
description: Which principle does this relate to?
options:
- "P1 — Non-Interactive by Default"
- "P2 — Structured, Parseable Output"
- "P3 — Progressive Help Discovery"
- "P4 — Fail Fast with Actionable Errors"
- "P5 — Safe Retries and Explicit Mutation Boundaries"
- "P6 — Composable and Predictable Command Structure"
- "P7 — Bounded, High-Signal Responses"
- "General / cross-cutting"
validations:
required: true
- type: textarea
id: question
attributes:
label: Question
description: "What would you like to know about the standard?"
placeholder: |
Does P4's MUST on exit codes apply to CLIs that use a single non-zero code
for all errors but include structured error details in stderr JSON?
validations:
required: true
- type: textarea
id: ai-disclosure
attributes:
label: AI disclosure
description: "One sentence: what part of this question was AI-written, what was human-written?"
placeholder: "Entirely human-written."
validations:
required: true
- type: textarea
id: agent-instructions
attributes:
label: For agents
description: "Agents: expand this section before filing."
value: |
<details>
<summary>Agent filing instructions</summary>

1. **Search first.** Run `gh search issues --repo brettdavies/agentnative "<keywords>"` to check for duplicates.
2. **AI disclosure is required.** Fill the field above honestly.
3. See [CONTRIBUTING.md](https://github.com/brettdavies/agentnative/blob/main/CONTRIBUTING.md) for full guidelines.
</details>
validations:
required: false
Loading