Skip to content

Update GitHub templates#722

Merged
forstmeier merged 16 commits intomasterfrom
update-github-issue-templates
Jan 27, 2026
Merged

Update GitHub templates#722
forstmeier merged 16 commits intomasterfrom
update-github-issue-templates

Conversation

@forstmeier
Copy link
Copy Markdown
Collaborator

@forstmeier forstmeier commented Jan 25, 2026

Overview

Changes

  • overhaul issue template
  • minor cleanup to pull request template

Comments

This is to better structure stuff for bot instructions.

Summary by CodeRabbit

  • Chores

    • Consolidated issue templates into a single standardized template and removed older per-type templates.
    • Updated pull-request wording and prompts.
    • Disabled blank issue creation via template configuration.
  • Documentation

    • Added a brief resources line to the README.
    • Updated license attribution and refreshed Code of Conduct, Contributing, and Security content to reflect new project naming.

✏️ Tip: You can customize this high-level summary in your review settings.

@forstmeier forstmeier self-assigned this Jan 25, 2026
@github-project-automation github-project-automation Bot moved this to To Do in Overview Jan 25, 2026
@forstmeier forstmeier moved this from To Do to In Progress in Overview Jan 25, 2026
@coderabbitai
Copy link
Copy Markdown
Contributor

coderabbitai Bot commented Jan 25, 2026

📝 Walkthrough

Walkthrough

Removes legacy bug/feature issue templates, adds a consolidated issue template and config to disable blank issues, updates the pull request template, and updates repository metadata and docs (README, LICENSE, CODE_OF_CONDUCT, CONTRIBUTING, SECURITY).

Changes

Cohort / File(s) Summary
Removed issue templates
.github/ISSUE_TEMPLATE/BUG.md, .github/ISSUE_TEMPLATE/FEATURE.md
Deleted two legacy issue template files that provided frontmatter and structured prompts for bug and feature reports.
Unified issue template & config
.github/ISSUE_TEMPLATE/ISSUE_TEMPLATE.md, .github/ISSUE_TEMPLATE/config.yaml
Added a consolidated issue template with frontmatter and Overview/Context + Changes sections; added config.yaml setting blank_issues_enabled: false.
Pull request template
.github/PULL_REQUEST_TEMPLATE.md
Updated header "Comments" → "Context", added guidance to apply relevant labels, removed an unused comment line, and corrected an HTML comment closure.
Repository metadata & docs
LICENSE.md, README.md, .github/CODE_OF_CONDUCT.md, .github/CONTRIBUTING.md, .github/SECURITY.md
Updated project attribution/name and contact/repository references; small README addition and LICENSE copyright owner change.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Possibly related PRs

🚥 Pre-merge checks | ✅ 3
✅ Passed checks (3 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title 'Update GitHub templates' directly aligns with the main changes across the pull request, which involve modifying issue templates, pull request templates, and related GitHub configuration files.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment
  • Commit unit tests in branch update-github-issue-templates

Comment @coderabbitai help to get the list of available commands and usage tips.

Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR standardizes GitHub issue and pull request templates by introducing a "type" field to replace redundant repository labels and reorganizing section headers for better consistency.

Changes:

  • Added "type" field to issue templates (bug, feature, task) to replace label-based categorization
  • Renamed "Comments" to "Context" and restructured section headers across all templates for consistency
  • Updated project references from "pocketsizefund/11" to "oscmcompany/1"

Reviewed changes

Copilot reviewed 4 out of 4 changed files in this pull request and generated no comments.

File Description
.github/PULL_REQUEST_TEMPLATE.md Renamed "Comments" section to "Context" and removed instruction to delete unused headers
.github/ISSUE_TEMPLATE/TASK.md New task template with "type: task" field and standardized "Context" and "Changes" sections
.github/ISSUE_TEMPLATE/FEATURE.md Added "type: feature" field, replaced labels, updated project reference, and renamed sections to "Context" and "Changes"
.github/ISSUE_TEMPLATE/BUG.md Added "type: bug" field, replaced labels, updated project reference, and renamed sections to "Context" and "Changes"

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Copy link
Copy Markdown
Contributor

@coderabbitai coderabbitai Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 2

🤖 Fix all issues with AI agents
In @.github/ISSUE_TEMPLATE/FEATURE.md:
- Around line 11-18: Remove trailing spaces from the section header lines "##
Context " and "## Changes " so they read "## Context" and "## Changes"; update
the .github/ISSUE_TEMPLATE/FEATURE.md file to trim any trailing whitespace on
those headers (and any other header lines) to satisfy MD009 and eliminate lint
noise.

In @.github/PULL_REQUEST_TEMPLATE.md:
- Around line 10-11: The header line "## Context " contains a trailing space
causing MD009 lint noise; remove the trailing whitespace so the header reads
exactly "## Context" (update the markdown header in the PULL_REQUEST_TEMPLATE
where the header string appears) to satisfy the linter.

Comment thread .github/ISSUE_TEMPLATE/FEATURE.md Outdated
Comment thread .github/PULL_REQUEST_TEMPLATE.md Outdated
@greptile-apps
Copy link
Copy Markdown
Contributor

greptile-apps Bot commented Jan 25, 2026

Greptile Overview

Greptile Summary

This PR consolidates GitHub issue templates from three separate templates (BUG, FEATURE, TASK) into a single unified ISSUE_TEMPLATE.md and updates branding across documentation files from "pocketsizefund"/"Pocket Size Fund" to "Open Source Capital Management"/"oscmcompany".

  • Replaced separate bug, feature, and task templates with unified issue template that covers all three types
  • Added config.yaml to disable blank issues, enforcing template usage
  • Renamed "Comments" section to "Context" in pull request template for clarity
  • Updated project reference from pocketsizefund/11 to oscmcompany/1
  • Removed emojis from documentation headers
  • Updated all social media links from @pocketsizefund to @oscmcompany

The unified template approach simplifies the issue creation workflow while maintaining guidance for different issue types through comments. The changes align with the repository rebranding effort.

Confidence Score: 5/5

  • This PR is safe to merge with no risk
  • All changes are documentation and template updates with no code modifications. The unified issue template maintains all necessary functionality while simplifying the workflow, and the branding updates are consistent across all files.
  • No files require special attention

Important Files Changed

Filename Overview
.github/ISSUE_TEMPLATE/ISSUE_TEMPLATE.md Created unified issue template covering bugs, features, and tasks with updated project reference
.github/ISSUE_TEMPLATE/config.yaml Added configuration to disable blank issues, enforcing template usage
.github/PULL_REQUEST_TEMPLATE.md Renamed 'Comments' to 'Context', added label application reminder, removed unnecessary comment

Copy link
Copy Markdown
Contributor

@greptile-apps greptile-apps Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

3 files reviewed, 3 comments

Edit Code Review Agent Settings | Greptile

Comment thread .github/ISSUE_TEMPLATE/BUG.md Outdated
Comment thread .github/ISSUE_TEMPLATE/FEATURE.md Outdated
Comment thread .github/ISSUE_TEMPLATE/TASK.md Outdated
coderabbitai[bot]
coderabbitai Bot previously approved these changes Jan 25, 2026
@forstmeier forstmeier marked this pull request as draft January 25, 2026 18:54
@forstmeier forstmeier marked this pull request as ready for review January 25, 2026 19:20
Copilot AI review requested due to automatic review settings January 25, 2026 19:20
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 5 out of 5 changed files in this pull request and generated no new comments.


💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Copy link
Copy Markdown
Contributor

@coderabbitai coderabbitai Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 3

🤖 Fix all issues with AI agents
In @.github/ISSUE_TEMPLATE/ISSUE_TEMPLATE.md:
- Line 10: The header line "## Context " has a trailing space violating MD009;
remove the trailing whitespace so the header reads exactly "## Context" (ensure
no extra spaces at end of the line) to fix the Markdown lint error.
- Line 19: The "## Changes " markdown header has a trailing space that violates
MD009; remove the trailing whitespace so the header reads exactly "## Changes"
(update the header line in .github/ISSUE_TEMPLATE/ISSUE_TEMPLATE.md to eliminate
the extra space character).
- Around line 1-6: Remove the trailing spaces from the YAML front-matter fields
so parsers don't choke: edit the front-matter entries "name: Issue " and "about:
Create an issue " and trim the trailing spaces to become "name: Issue" and
"about: Create an issue"; ensure there are no extra spaces after the field
values and keep the rest of the front-matter (title, projects) unchanged.
♻️ Duplicate comments (1)
.github/PULL_REQUEST_TEMPLATE.md (1)

11-11: Remove trailing space on the header line.

The header "## Context" contains a trailing space causing MD009 lint violations.

Proposed fix
-## Context 
+## Context

Comment thread .github/ISSUE_TEMPLATE/ISSUE_TEMPLATE.md Outdated
Comment thread .github/ISSUE_TEMPLATE/ISSUE_TEMPLATE.md Outdated
coderabbitai[bot]
coderabbitai Bot previously approved these changes Jan 25, 2026
Copy link
Copy Markdown
Contributor

@coderabbitai coderabbitai Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🤖 Fix all issues with AI agents
In @.github/ISSUE_TEMPLATE/ISSUE_TEMPLATE.md:
- Around line 1-6: The issue template front-matter (currently containing name,
about, title, projects) lacks a type indicator to distinguish
bugs/features/tasks; update the front-matter to include a type field (or labels
array) such as a "type" or "labels" key, or convert the template to GitHub issue
form YAML and add a dropdown field for "type" so consumers can programmatically
select bug/feature/task; modify the existing front-matter keys (name, about,
title, projects) to include this new key and ensure the YAML syntax matches
GitHub's issue template/form schema.

Comment thread .github/ISSUE_TEMPLATE/ISSUE_TEMPLATE.md
coderabbitai[bot]
coderabbitai Bot previously approved these changes Jan 25, 2026
@forstmeier forstmeier changed the title Update GitHub templates with "type" formats Update GitHub templates Jan 25, 2026
Copy link
Copy Markdown
Contributor

@coderabbitai coderabbitai Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 3

🤖 Fix all issues with AI agents
In @.github/CODE_OF_CONDUCT.md:
- Line 3: Update the line containing "The open source capital management
company" to remove the trailing space and hyphenate the compound modifier:
change it to "The open-source capital management company" (ensure no trailing
whitespace remains at the end of the line).

In @.github/CONTRIBUTING.md:
- Line 3: Update the sentence in CONTRIBUTING.md that currently reads "The open
source capital management company " by removing the trailing space and
hyphenating "open-source" so it becomes "The open-source capital management
company"; ensure no extra whitespace remains at the end of the line.

In @.github/SECURITY.md:
- Line 3: Replace the trailing-space, unhyphenated phrase in the line containing
"> The open source capital management company" with a hyphenated, trimmed
version: "The open‑source capital management company" (remove the trailing space
and add the hyphen between "open" and "source") so the wording matches other
docs.

Comment thread .github/CODE_OF_CONDUCT.md Outdated
Comment thread .github/CONTRIBUTING.md Outdated
Comment thread .github/SECURITY.md Outdated
Copy link
Copy Markdown
Contributor

@greptile-apps greptile-apps Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

1 file reviewed, 1 comment

Edit Code Review Agent Settings | Greptile

Comment thread .github/ISSUE_TEMPLATE/ISSUE_TEMPLATE.md
forstmeier and others added 2 commits January 25, 2026 22:31
Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>
Copilot AI review requested due to automatic review settings January 26, 2026 14:52
Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>
Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>
chrisaddy
chrisaddy previously approved these changes Jan 26, 2026
coderabbitai[bot]
coderabbitai Bot previously approved these changes Jan 26, 2026
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 10 out of 10 changed files in this pull request and generated 6 comments.


💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread README.md Outdated
Comment thread .github/CODE_OF_CONDUCT.md Outdated
Comment thread LICENSE.md
Comment thread LICENSE.md Outdated
Comment thread .github/SECURITY.md Outdated
Comment thread .github/CONTRIBUTING.md Outdated
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
@chrisaddy chrisaddy dismissed stale reviews from coderabbitai[bot] and themself via 7ab6630 January 26, 2026 14:55
Copilot AI review requested due to automatic review settings January 26, 2026 14:55
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
chrisaddy and others added 2 commits January 26, 2026 09:56
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
coderabbitai[bot]
coderabbitai Bot previously approved these changes Jan 26, 2026
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 10 out of 10 changed files in this pull request and generated 2 comments.


💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread .github/SECURITY.md Outdated
Comment thread .github/CONTRIBUTING.md Outdated
@forstmeier forstmeier merged commit 7ddff9f into master Jan 27, 2026
4 checks passed
@github-project-automation github-project-automation Bot moved this from In Progress to Done in Overview Jan 27, 2026
@forstmeier forstmeier deleted the update-github-issue-templates branch January 27, 2026 02:17
chrisaddy added a commit that referenced this pull request Jan 27, 2026
Labels:
- Rename refining -> in-refinement, needs-attention -> attention-needed
- Add 'ralph' actor label for human/Ralph handoff flexibility
- Apply consistent color scheme per reviewer suggestion

Commands:
- Add 'mask ralph ready <issue_number>' command
- Extract shared preflight checks to tools/ralph-preflight.sh
- Auto-assign current GitHub user to issue and PR

Documentation:
- Change [issue] -> [issue_number] for clarity
- Add compaction note to Ralph Learnings section
- Document auto-assignment in workflow steps

Output formatting:
- Remove separator lines (===) from echo output
- Add git status and recent commits to error comments
- Use HTML comments for placeholders in backlog report

Removed:
- Staleness checking (handled by stale workflow action)

Template consolidation:
- Remove separate BUG.md, FEATURE.md, SPEC.md (merged via #722)
- Update consolidated ISSUE_TEMPLATE.md with in-refinement label

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
chrisaddy added a commit that referenced this pull request Jan 28, 2026
* Add Ralph autonomous development workflow

Integrate Ralph pattern for autonomous AI development loops using GitHub
issues as specs. This enables structured spec refinement and autonomous
implementation with proper context rotation.

Changes:
- Add mask ralph spec command for interactive spec building
- Add mask ralph loop command for autonomous implementation
- Create SPEC.md issue template with standard format
- Document Ralph workflow in CLAUDE.md
- Create in-progress and needs-attention labels

The workflow uses GitHub issue checkboxes as state, labels for lifecycle
tracking (refining -> ready -> in-progress), and pre-commit hooks as
the verification gate.

Closes #723

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

* add learnings

* Add mask ralph backlog command for issue backlog review

Implements #727: Adds a new command to the Ralph workflow that analyzes
open GitHub issues for:
- Potential duplicates or overlapping issues
- Stale issues (no activity for 60+ days)
- Issues that may already be implemented (via codebase search)
- Consolidation opportunities

The command posts analysis results as comments on a dedicated
"Backlog Review" tracking issue, creating it if it doesn't exist.

Key features:
- On-demand execution via `mask ralph backlog`
- Uses Claude to analyze issue similarities and search codebase
- Suggestions only (no auto-closing)
- Includes confidence levels on findings
- Creates/reuses backlog-review labeled tracking issue

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

* Document mask ralph backlog command in CLAUDE.md

Add backlog command to the Ralph Workflow documentation and include
the new backlog-review label in the labels section.

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

* Add mask ralph pr command for PR review feedback

Implements #729: Adds a command to process PR review feedback with
two phases:

Planning (Interactive):
- Auto-detects PR from current branch (or use --pr flag)
- Fetches unresolved review threads via GraphQL API
- Presents each suggestion one by one
- User can Accept, Skip, Modify, or Quit
- Builds a plan of approved changes

Execution (Autonomous):
- Claude implements all approved suggestions
- Commits changes with meaningful messages
- Posts reply to each thread explaining what was done
- Resolves conversations via GraphQL API
- Pushes changes

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

* Address PR review: fix Ralph workflow issues

- Remove dates from spec template (issue state has date info)
- Move tmpfile creation and trap outside loop to prevent orphaned temp files
- Add ERR trap handler to clean up and update labels on unexpected exits
- Add explicit gh auth status check before fetching issue labels
- Add <promise>COMPLETE</promise> marker to PR body per requirements
- Push branch before posting failure comment so reviewers can access it
- Use --template flag for gh issue create instead of inline body
- Use JSON output for issue creation to reliably parse issue numbers
- Remove hardcoded pocketsizefund/11 project reference from all templates

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

* Add project field to issue templates

Link new issues to oscmcompany/1 project board automatically.

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

* Truncate large code blocks in mask ralph pr planning display

Show first 3 lines of code blocks with line count summary instead of
full code. Makes review comments with large suggested diffs easier
to parse during interactive planning.

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

* Update CLAUDE.md

Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>

* Update maskfile.md

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

* Address review: detect default branch dynamically instead of hardcoding master

Changed the ralph loop pre-flight checks to dynamically detect the repository's
default branch instead of assuming "master". This supports repositories that use
"main" or other branch names as their default.

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

* Add mask ralph setup command to create required labels

Creates refining, ready, in-progress, needs-attention, and backlog-review
labels if they don't exist. Skips labels that already exist.

Run `mask ralph setup` once before using other Ralph commands.

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

* Use dynamic default branch for modified files diff

Replace hardcoded origin/master with origin/${default_branch} in
the failure comment's modified files comparison.

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

* Add jq checks and error trap to ralph commands

- Add jq dependency check to loop and backlog commands
- Add EXIT trap in loop command to clean up labels and post diagnostic
  comment if script fails unexpectedly (e.g., pipeline error)
- Clear trap on handled exit paths (success and max iterations)

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

* Add gh and claude dependency checks to ralph loop

Consistent with other Ralph commands, check for gh and claude
before running the loop.

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

* Fix PR review issues: jq check, quit behavior, push order

- Add jq dependency check to spec command
- Fix quit (Q) to exit immediately instead of continuing to execution
- Push changes before posting replies/resolving threads to ensure
  code is available when conversations are marked resolved

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

* Address remaining PR review comments

- Add --dangerously-skip-permissions to backlog command for codebase search
- Fix results_json parsing to handle multiline output from Claude
- Add explicit commit instruction to loop system prompt

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

* Default issue templates to refining label

All new issues start in refining state until explicitly marked ready.

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

* Address PR review feedback from forstmeier

Labels:
- Rename refining -> in-refinement, needs-attention -> attention-needed
- Add 'ralph' actor label for human/Ralph handoff flexibility
- Apply consistent color scheme per reviewer suggestion

Commands:
- Add 'mask ralph ready <issue_number>' command
- Extract shared preflight checks to tools/ralph-preflight.sh
- Auto-assign current GitHub user to issue and PR

Documentation:
- Change [issue] -> [issue_number] for clarity
- Add compaction note to Ralph Learnings section
- Document auto-assignment in workflow steps

Output formatting:
- Remove separator lines (===) from echo output
- Add git status and recent commits to error comments
- Use HTML comments for placeholders in backlog report

Removed:
- Staleness checking (handled by stale workflow action)

Template consolidation:
- Remove separate BUG.md, FEATURE.md, SPEC.md (merged via #722)
- Update consolidated ISSUE_TEMPLATE.md with in-refinement label

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

* Update maskfile.md

Co-authored-by: greptile-apps[bot] <165735046+greptile-apps[bot]@users.noreply.github.com>

---------

Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>
Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: greptile-apps[bot] <165735046+greptile-apps[bot]@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

Archived in project

Development

Successfully merging this pull request may close these issues.

3 participants