the signals and their derived score are provisional and subject to change.
validate manually before sharing.
47573c4d5c5075a484e47e5d5a481e0c2cd71fa7a07a162590d81 month agoClaude-Session: https://claude.ai/code/session_01KsRLJh9QBc69K2WZBEoNf8a07a162590d81 month agoClaude-Session: https://claude.ai/code/session_01KsRLJh9QBc69K2WZBEoNf8a07a162590d81 month agoCo-authored-by: Claude <noreply@anthropic.com>19ba794ff7ca4 months agoCo-authored-by: Copilot <198982749+Copilot@users.noreply.github.com>83e56d63f37a4 months agoCo-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>83e56d63f37a4 months agoCo-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>40116b42152e4 months agoCo-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>a89ef67909af5 months agoCo-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>c49c5b52c56c5 months agohttps://claude.ai/code/session_01BwkVcHyk7eJKBDWgyUdnhJc49c5b52c56c5 months agoCo-authored-by: Claude <noreply@anthropic.com>c49c5b52c56c5 months agoCo-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>a29f38dd828c5 months agoCo-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>056cb721e1d55 months agoCo-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>30e2020b996e5 months agoCo-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>5cfb1cddde626 months agoCo-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>99904f32aa436 months agoCo-authored-by: Copilot <198982749+Copilot@users.noreply.github.com>50a0bd4dde257 months agoCo-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>50a0bd4dde257 months agoCo-authored-by: Copilot <198982749+Copilot@users.noreply.github.com>e0750428fb207 months agoCo-authored-by: Copilot <198982749+Copilot@users.noreply.github.com>20085e73d28a7 months agoCo-authored-by: Copilot <198982749+Copilot@users.noreply.github.com>20085e73d28a7 months agoCo-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>7b2638bcd4d38 months agoCo-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>1793cf578ba68 months agoCo-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>62b717aac4d58 months agoCo-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>62b717aac4d58 months agoCo-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>694ecf0bde108 months agoCo-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>382b8bcb8cf08 months agoCo-authored-by: Copilot <198982749+Copilot@users.noreply.github.com>382b8bcb8cf08 months agoCo-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>1a5d178951388 months agoCo-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>1a5d178951388 months agoCo-authored-by: Copilot <198982749+Copilot@users.noreply.github.com>976e589fed588 months agoCo-authored-by: Copilot Autofix powered by AI <62310815+github-advanced-security[bot]@users.noreply.github.com>3b36b65512ef8 months agoCo-authored-by: Copilot Autofix powered by AI <62310815+github-advanced-security[bot]@users.noreply.github.com>8ed0017fffff8 months agoCo-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>50db2954af3e8 months agoCo-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>fe0c0ee10fa18 months agoCopilotfe0c0ee10fa18 months agoCo-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com># bash-logger Agent Instructions
This document provides guidance for AI agents contributing to the bash-logger project.
Follow these standards when generating, modifying, or reviewing code.
## Agent Skills
This repository provides skills in `.claude/skills/`. Supporting agents (GitHub Copilot,
Claude Code, and others implementing the Agent Skills open standard) load these automatically.
Each skill contains the authoritative, step-by-step workflow for its domain:
* **[linting-code](.claude/skills/lintingAGENTS.md../AGENTS.md---
name: linting-code
description: >
Lints shell scripts and Markdown files in the bash-logger repository using the project's
configured toolchain. Use this skill whenever checking code quality, fixing linting errors,
or running lint as part of a pre-commit or pre-PR workflow.
---
# Linting Code
## Tools and where configuration lives
| Tool | Checks | Config |
| ------------ | ---------
name: running-tests
description: >
Runs the bash-logger test suite — either the full suite or a targeted subset. Use this skill
whenever running, selecting, or interpreting tests in this repository. Covers discovering
available suites, choosing which to run after a change, correct invocation syntax, and reading
test output.
---
# Running Tests
## Discover available suites first
Never assume which suites exist. Always discover them at runtime:
```bash
ls tests/test_*.sh | grep -v test_examp---
name: writing-commits
description: >
Generates correctly formatted commit messages and pull request descriptions for this repository.
Uses Conventional Commits / semantic-release format with issue references. Use this skill
whenever writing, reviewing, or amending a commit message or drafting a PR title and body.
---
# Writing Commits and Pull Requests
## Commit message format
```
<type>(<scope>): <subject>
<body>
<footer>
```
Commit history drives automated versioning via `semantic-release`---
name: writing-tests
description: >
Adds new tests to the bash-logger test suite. Covers creating new test suites, adding tests to
existing suites, correct use of assertions, isolation patterns, and the mandatory call
registration pattern. Use this skill whenever writing, extending, or fixing tests in the tests/
directory.
---
# Writing Tests
Full assertion API reference is in `docs/testing.md`. Full contributor guide is in `docs/writing-tests.md`. This skill is the step-by-step agent workflow.---
name: pre-pr-checks
description: >
Runs the full gate sequence before raising a pull request on bash-logger. Covers linting,
targeted tests, full test suite, code review checklist, commit message audit, PR description
requirements, and branch hygiene. Use this skill before pushing to a shared branch or opening
a PR.
---
# Pre-PR Checks
Work through these steps in order. Each builds on the last.
## 1. Lint
```bash
make lint
```
Fix all ShellCheck and MarkdownLint failures. MarkdownLint auto----
name: security-review
description: >
Reviews code changes in bash-logger for security issues across all protected domains. Use this
skill whenever adding new features that handle external input, changing sanitization behaviour,
adding config options, or reviewing a PR for security. Covers input sanitization, file system
safety, config injection, environment variable attacks, journal command validation, sensitive
data handling, and unsafe flag governance.
---
# Security Review
## When to use none