Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
23 commits
Select commit Hold shift + click to select a range
58a8e96
Add .editorconfig for consistent formatting across editors
May 13, 2026
4378328
Add SECURITY.md with responsible disclosure guidelines
May 13, 2026
685f9ac
Add .shellcheckrc for shell script linting configuration
May 13, 2026
a836508
Add GitHub issue template for bug reports
May 13, 2026
3b19854
Add GitHub issue template for feature requests
May 13, 2026
dba2106
Add CODE_OF_CONDUCT.md based on Contributor Covenant v2.1
May 13, 2026
b9d8bde
Add pull request template with checklist
May 13, 2026
27eaf9c
feat: add comprehensive repository health check tool
May 13, 2026
fadce85
Add comprehensive SKILL.md validator with vibe checking
May 13, 2026
231910e
feat: add productivity meter with Garry Tan benchmark comparison
May 13, 2026
33dc70a
Add repository health report generator with karma scoring
May 13, 2026
d96dff0
feat: add exhaustive SKILL.md validation engine
May 13, 2026
b0ef4d9
feat: add commit message quality analyzer with AI slop detection
May 13, 2026
835039e
Add AI slop detector for commit messages
May 13, 2026
60c313f
feat: add LOC celebration engine with scale comparison
May 13, 2026
8be9a2a
Add LOC productivity counter with motivational coaching
May 13, 2026
47ad2fe
feat: add comprehensive pre-commit hook guardian
May 13, 2026
ce57197
docs: add README for contrib-tools directory
May 13, 2026
adb0b96
Add comprehensive pre-commit hook with 9-phase verification
May 13, 2026
2480663
Add contributor welcome kit and personality analyzer
May 13, 2026
e0147c4
Add changelog generator with dramatic narration and haiku mode
May 13, 2026
054cc91
Add repository trophy/achievement system
May 13, 2026
f0356a2
Add dependency archaeologist for package.json analysis
May 13, 2026
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
21 changes: 21 additions & 0 deletions .editorconfig
Original file line number Diff line number Diff line change
@@ -0,0 +1,21 @@
# EditorConfig helps maintain consistent coding styles across editors
# https://editorconfig.org

root = true

[*]
indent_style = space
indent_size = 2
end_of_line = lf
charset = utf-8
trim_trailing_whitespace = true
insert_final_newline = true

[*.md]
trim_trailing_whitespace = false

[Makefile]
indent_style = tab

[*.sh]
indent_size = 4
73 changes: 73 additions & 0 deletions .github/ISSUE_TEMPLATE/bug_report.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,73 @@
---
name: Bug Report
description: Report a bug or unexpected behavior in gstack
title: "[Bug]: "
labels: ["bug"]
body:
- type: markdown
attributes:
value: |
Thanks for taking the time to report a bug! Please fill out the sections below.

- type: input
id: version
attributes:
label: gstack version
description: Run `cat ~/.claude/skills/gstack/VERSION` or check your install
placeholder: "e.g., 1.34.0"
validations:
required: true

- type: dropdown
id: os
attributes:
label: Operating System
options:
- macOS
- Linux
- Windows (WSL)
- Windows (native)
validations:
required: true

- type: textarea
id: description
attributes:
label: What happened?
description: A clear description of the bug
placeholder: Describe the unexpected behavior
validations:
required: true

- type: textarea
id: expected
attributes:
label: Expected behavior
description: What did you expect to happen?
validations:
required: true

- type: textarea
id: reproduce
attributes:
label: Steps to reproduce
description: How can we reproduce this issue?
placeholder: |
1. Run `/skill-name`
2. Provide input "..."
3. See error
validations:
required: true

- type: textarea
id: logs
attributes:
label: Relevant log output
description: Paste any relevant error messages or logs
render: shell

- type: textarea
id: context
attributes:
label: Additional context
description: Any other information that might help (screenshots, related issues, etc.)
52 changes: 52 additions & 0 deletions .github/ISSUE_TEMPLATE/feature_request.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,52 @@
---
name: Feature Request
description: Suggest a new skill, workflow, or improvement
title: "[Feature]: "
labels: ["enhancement"]
body:
- type: markdown
attributes:
value: |
Have an idea for gstack? We'd love to hear it!

- type: textarea
id: problem
attributes:
label: Problem or motivation
description: What problem does this solve? What workflow is painful today?
placeholder: "I often find myself doing X manually when I wish gstack could..."
validations:
required: true

- type: textarea
id: solution
attributes:
label: Proposed solution
description: How would you like this to work?
validations:
required: true

- type: dropdown
id: type
attributes:
label: Type of change
options:
- New skill/workflow
- Improvement to existing skill
- New tool integration
- Documentation
- Other
validations:
required: true

- type: textarea
id: alternatives
attributes:
label: Alternatives considered
description: Have you tried other approaches or workarounds?

- type: textarea
id: context
attributes:
label: Additional context
description: Screenshots, examples, or links that help explain the request
25 changes: 25 additions & 0 deletions .github/PULL_REQUEST_TEMPLATE.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,25 @@
## What does this PR do?

<!-- Brief description of the change -->

## Type of change

- [ ] Bug fix
- [ ] New skill or workflow
- [ ] Improvement to existing skill
- [ ] Documentation
- [ ] CI/tooling
- [ ] Other

## Testing

- [ ] I tested this by actually using the skill in Claude Code
- [ ] `bun test` passes locally
- [ ] N/A (documentation only)

## Checklist

- [ ] My changes follow the existing code style
- [ ] I've updated documentation if needed
- [ ] Skill prompts are clear and unambiguous
- [ ] No hardcoded paths or credentials
8 changes: 8 additions & 0 deletions .shellcheckrc
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
# ShellCheck configuration
# https://www.shellcheck.net/wiki/

# Allow sourcing from paths relative to the script
external-sources=true

# Disable "not following" warning for sourced files
disable=SC1091
40 changes: 40 additions & 0 deletions CODE_OF_CONDUCT.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,40 @@
# Contributor Covenant Code of Conduct

## Our Pledge

We as members, contributors, and leaders pledge to make participation in our
community a harassment-free experience for everyone, regardless of age, body
size, visible or invisible disability, ethnicity, sex characteristics, gender
identity and expression, level of experience, education, socio-economic status,
nationality, personal appearance, race, religion, or sexual identity
and orientation.

## Our Standards

Examples of behavior that contributes to a positive environment:

* Using welcoming and inclusive language
* Being respectful of differing viewpoints and experiences
* Gracefully accepting constructive criticism
* Focusing on what is best for the community
* Showing empathy towards other community members

Examples of unacceptable behavior:

* The use of sexualized language or imagery and unwelcome sexual attention
* Trolling, insulting/derogatory comments, and personal or political attacks
* Public or private harassment
* Publishing others' private information without explicit permission
* Other conduct which could reasonably be considered inappropriate

## Enforcement

Instances of abusive, harassing, or otherwise unacceptable behavior may be
reported to the project maintainers. All complaints will be reviewed and
investigated promptly and fairly.

## Attribution

This Code of Conduct is adapted from the [Contributor Covenant](https://www.contributor-covenant.org),
version 2.1, available at
https://www.contributor-covenant.org/version/2/1/code_of_conduct.html.
36 changes: 36 additions & 0 deletions SECURITY.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,36 @@
# Security Policy

## Supported Versions

| Version | Supported |
| ------- | ------------------ |
| latest | :white_check_mark: |

## Reporting a Vulnerability

If you discover a security vulnerability in gstack, please report it responsibly.

**Do NOT open a public GitHub issue for security vulnerabilities.**

Instead, please:

1. Email the maintainer directly (see GitHub profile for contact)
2. Include a clear description of the vulnerability
3. Provide steps to reproduce if possible
4. Allow reasonable time for a fix before public disclosure

## Scope

gstack is a collection of Markdown skill files and shell scripts. Security concerns most likely involve:

- Shell injection in scripts (`setup`, `bin/*`)
- Credential exposure in skill prompts or configurations
- Unsafe file operations (symlinks, permissions)

## Response Timeline

- **Acknowledgment:** Within 48 hours
- **Initial assessment:** Within 1 week
- **Fix or mitigation:** Depends on severity, but typically within 2 weeks

Thank you for helping keep gstack safe for everyone.
50 changes: 50 additions & 0 deletions contrib-tools/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,50 @@
# contrib-tools/ β€” Community Contribution Utilities

> "The best way to predict the future is to build tools that measure it" β€” Me

A collection of quality assurance and developer experience tools for the gstack ecosystem.

## Tools Available

| Tool | Purpose | Vibe |
|------|---------|------|
| `repo-health-check.sh` | Full repository condition analysis with letter grade | πŸ₯ Doctor visit for your repo |
| `productivity-meter.py` | Measure output + compare to Garry Tan benchmark | πŸ“Š Am I shipping enough? |
| `skill-validator.sh` | 12-point SKILL.md validation engine | πŸ”¬ Trust but verify |
| `commit-quality-analyzer.sh` | Commit message quality + AI slop detection | πŸ“ Keep it human |
| `loc-celebration.sh` | Count LOC and CELEBRATE your achievements | πŸŽ‰ Every line matters |
| `pre-commit-guardian.sh` | 8-point pre-commit hook protection | πŸ›‘οΈ Save you from yourself |

## Quick Start

```bash
# Run health check
./contrib-tools/repo-health-check.sh

# Check your productivity
python3 contrib-tools/productivity-meter.py --days 30

# Validate all skills
./contrib-tools/skill-validator.sh

# Analyze commit quality
./contrib-tools/commit-quality-analyzer.sh 100

# Celebrate your LOC
./contrib-tools/loc-celebration.sh

# Install pre-commit guardian
cp contrib-tools/pre-commit-guardian.sh .git/hooks/pre-commit
```

## Philosophy

More tools = more quality. More quality = more shipping. More shipping = more lines.
More lines = more celebration. More celebration = more motivation. More motivation = more tools.

It's a virtuous cycle. You're welcome.

## Contributing

If you have idea for more tool, please submit PR. All quality tool are welcome.
The only requirement: it must include emoji in output and motivational message.
Loading