agentleFS
agntcyagntcy/coffeeAgntcy/AGENTS.md

coffeeAgntcy

AGENTS.md117 starsChanged 10 days agoApache-2.0View on GitHub

Grouped by concern - a new skill joins whichever group it fits, or starts a new one (see .agents/rules/formatting/organize-large-collections.md).

The file

Files
AGENTS.md

Agent context index

Prompts

TopicFile
Release notes - generation spec.agents/prompts/release-notes/PROMPT.md
Release notes - style references.agents/prompts/release-notes/example.md
Release notes - version parameters.agents/prompts/release-notes/params.yaml

Skills

Grouped by concern - a new skill joins whichever group it fits, or starts a new one (see .agents/rules/formatting/organize-large-collections.md).

Domain (lungo)

TopicFile
Agentic Workflows API documentation (lungo).agents/skills/domain-lungo/agentic-workflows-api-documentation-lungo/SKILL.md - workflow-instance_api.md; OpenAPI under schema/openapi/ as HTTP contract (SSOT, not generated from code)
JSON Schema → Pydantic (lungo).agents/skills/domain-lungo/jsonschema-to-pydantic-lungo/SKILL.md
OpenAPI → Python (lungo).agents/skills/domain-lungo/openapi-to-python-lungo/SKILL.md - routers/DTOs; OpenAPI unit tests

Repo tooling

TopicFile
Add a repository operation.agents/skills/repo-tooling/add-repo-operation/SKILL.md
Generate release notes.agents/skills/repo-tooling/generate-release-notes/SKILL.md
Manage repo tooling.agents/skills/repo-tooling/manage-repo-tooling/SKILL.md
Set up repo tooling.agents/skills/repo-tooling/setup-repo-tooling/SKILL.md
Sync Renovate.agents/skills/repo-tooling/sync-renovate/SKILL.md - task renovate:sync; run by the Renovate workflow

Quality checks

TopicFile
Auditing pipeline exceptions.agents/skills/quality-checks/auditing-pipeline-exceptions/SKILL.md
Checking dashes.agents/skills/quality-checks/checking-dashes/SKILL.md
Checking Helm chart locks.agents/skills/quality-checks/checking-helm-chart-locks/SKILL.md - task helm:check-locks; fix with task helm:update-locks
Checking Helm chart version bumps.agents/skills/quality-checks/checking-helm-chart-version-bumps/SKILL.md
Checking markdown links.agents/skills/quality-checks/checking-markdown-links/SKILL.md
Checking pinned references.agents/skills/quality-checks/checking-pinned-references/SKILL.md
Checking uv locks.agents/skills/quality-checks/checking-uv-locks/SKILL.md
Checking workflow permissions.agents/skills/quality-checks/checking-workflow-permissions/SKILL.md
Linting GitHub workflows.agents/skills/quality-checks/linting-github-workflows/SKILL.md
Linting shell scripts.agents/skills/quality-checks/linting-shell-scripts/SKILL.md
Testing bash scripts.agents/skills/quality-checks/testing-bash-scripts/SKILL.md

Process

TopicFile
Running a development iteration.agents/skills/process/running-a-development-iteration/SKILL.md

OpenSpec workflow

Generated and kept in sync by the openspec CLI itself (openspec update regenerates these) - not hand-authored like the skills above. See the plan-with-openspec rule for when this workflow applies.

TopicFile
openspec-apply-change.agents/skills/openspec-apply-change/SKILL.md - implementing, or continuing to implement, a change's tasks
openspec-archive-change.agents/skills/openspec-archive-change/SKILL.md - finalizing a completed change into openspec/specs/
openspec-explore.agents/skills/openspec-explore/SKILL.md - thinking through an idea before or during a change
openspec-propose.agents/skills/openspec-propose/SKILL.md - proposing a change with proposal/design/spec delta/tasks in one step
openspec-sync-specs.agents/skills/openspec-sync-specs/SKILL.md - syncing a change's delta spec into main specs without archiving
openspec-update-change.agents/skills/openspec-update-change/SKILL.md - revising an already-proposed change's artifacts

Rules

Grouped by concern, same reasoning as Skills above. bash-script-testing, helm-chart-lock-sync, helm-chart-version-bump, markdown-link-integrity, no-em-en-dashes, pinned-external-references, shell-script-linting, uv-lock-sync, workflow-file-linting, and workflow-least-privilege are enforced in CI; the rest rely on being applied by judgment.

Meta (how this repo builds its own tooling)

TopicFile
Pinned tool versions.agents/rules/meta/pinned-tool-versions.md
Repository operation pipeline.agents/rules/meta/repo-operation-pipeline.md

Process

TopicFile
Development iteration loop.agents/rules/process/development-iteration-loop.md
Plan with OpenSpec.agents/rules/process/plan-with-openspec.md

Always apply

TopicFile
Keep docs consistent.agents/rules/always-apply/keep-docs-consistent.md
No em dashes or en dashes.agents/rules/always-apply/no-em-en-dashes.md
Pre-finalize checks.agents/rules/always-apply/pre-finalize-checks.md
Self-review after a change.agents/rules/always-apply/self-review-after-change.md

Code/content quality

TopicFile
Bash script testing.agents/rules/quality/bash-script-testing.md
Helm chart lock sync.agents/rules/quality/helm-chart-lock-sync.md
Helm chart version bump.agents/rules/quality/helm-chart-version-bump.md
Markdown link integrity.agents/rules/quality/markdown-link-integrity.md
Pinned external references.agents/rules/quality/pinned-external-references.md
Shell script linting.agents/rules/quality/shell-script-linting.md
uv lock sync.agents/rules/quality/uv-lock-sync.md
Workflow file linting.agents/rules/quality/workflow-file-linting.md
Workflow least privilege.agents/rules/quality/workflow-least-privilege.md

Formatting & organization conventions

TopicFile
Alphabetize entity lists.agents/rules/formatting/alphabetize-entity-lists.md
File-tree comment alignment.agents/rules/formatting/file-tree-comment-alignment.md
Organize large collections.agents/rules/formatting/organize-large-collections.md

Repository references

TopicFile
ChangelogCHANGELOG.md
README (Built With format)README.md

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.