Skip to content

notque/vexjoy-agent / skills/programming/programming

programming

Flagged

Language rules, workflows, and tooling: Go, Python, Rust, Kotlin, Swift, PHP, TypeScript type checks and debugging, OpenStack Python, MCP local-docs servers, Node.js backend APIs.

FileKindSize
SKILL.mdskill md19.3 KB
references/go/code-review.mdmarkdown12.0 KB
references/go/code-review/common-review-comments.mdmarkdown6.6 KB
references/go/concurrency.mdmarkdown11.5 KB
references/go/concurrency/concurrency-patterns.mdmarkdown5.7 KB
references/go/error-handling.mdmarkdown10.8 KB
references/go/error-handling/patterns.mdmarkdown4.2 KB
references/go/google-style-guide/SHA256SUMSother313 B
references/go/google-style-guide/UPSTREAM_REVISIONother41 B
references/go/google-style-guide/best-practices/part-01.mdmarkdown10.0 KB
references/go/google-style-guide/best-practices/part-02.mdmarkdown15.0 KB
references/go/google-style-guide/best-practices/part-03.mdmarkdown14.1 KB
references/go/google-style-guide/best-practices/part-04.mdmarkdown13.5 KB
references/go/google-style-guide/best-practices/part-05.mdmarkdown10.5 KB
references/go/google-style-guide/best-practices/part-06.mdmarkdown14.4 KB
references/go/google-style-guide/best-practices/part-07.mdmarkdown16.1 KB
references/go/google-style-guide/best-practices/part-08.mdmarkdown11.4 KB
references/go/google-style-guide/best-practices/part-09.mdmarkdown13.7 KB
references/go/google-style-guide/best-practices/part-10.mdmarkdown16.9 KB
references/go/google-style-guide/decisions/part-01.mdmarkdown15.0 KB
references/go/google-style-guide/decisions/part-02.mdmarkdown12.5 KB
references/go/google-style-guide/decisions/part-03.mdmarkdown11.5 KB
references/go/google-style-guide/decisions/part-04.mdmarkdown8.4 KB
references/go/google-style-guide/decisions/part-05.mdmarkdown9.8 KB
references/go/google-style-guide/decisions/part-06.mdmarkdown14.7 KB
references/go/google-style-guide/decisions/part-07.mdmarkdown13.3 KB
references/go/google-style-guide/decisions/part-08.mdmarkdown14.3 KB
references/go/google-style-guide/decisions/part-09.mdmarkdown15.3 KB
references/go/google-style-guide/decisions/part-10.mdmarkdown8.3 KB
references/go/google-style-guide/guide/part-01.mdmarkdown16.3 KB
references/go/google-style-guide/guide/part-02.mdmarkdown3.0 KB
references/go/google-style-guide/index.mdmarkdown8.4 KB
references/go/preferred-patterns.mdmarkdown12.5 KB
references/go/preferred-patterns/code-examples.mdmarkdown11.6 KB
references/go/quality-gate.mdmarkdown7.3 KB
references/go/quality-gate/common-lint-errors.jsonconfig7.6 KB
references/go/quality-gate/examples.mdmarkdown11.0 KB
references/go/quality-gate/makefile-targets.jsonconfig5.1 KB
references/go/sapcc-conventions.mdmarkdown34.6 KB
references/go/sapcc-conventions/api-design-detailed.mdmarkdown22.7 KB
references/go/sapcc-conventions/architecture-patterns.mdmarkdown18.6 KB
references/go/sapcc-conventions/build-ci-detailed.mdmarkdown18.7 KB
references/go/sapcc-conventions/error-handling-detailed.mdmarkdown20.1 KB
references/go/sapcc-conventions/extended-patterns.mdmarkdown7.1 KB
references/go/sapcc-conventions/go-bits-philosophy-detailed.mdmarkdown24.5 KB
references/go/sapcc-conventions/library-reference.mdmarkdown14.0 KB
references/go/sapcc-conventions/pr-mining-insights.mdmarkdown17.5 KB
references/go/sapcc-conventions/review-standards.mdmarkdown10.5 KB
references/go/sapcc-conventions/sapcc-code-patterns.mdmarkdown46.2 KB
references/go/testing.mdmarkdown9.7 KB
references/go/testing/go-benchmark-and-concurrency.mdmarkdown5.6 KB
references/go/testing/go-test-patterns.mdmarkdown9.0 KB
references/golang-general.mdmarkdown8.9 KB
references/golang-general/go-modern-code.mdmarkdown17.2 KB
references/golang-general/go-verification-workflow.mdmarkdown5.0 KB
references/golang-general/go-version-idioms.mdmarkdown6.8 KB
references/kotlin-general.mdmarkdown7.5 KB
references/kotlin-general/kotlin-patterns.mdmarkdown7.9 KB
references/kotlin-general/kotlin-security-testing.mdmarkdown4.4 KB
references/kotlin-general/kotlin-security.mdmarkdown11.1 KB
references/kotlin/concurrency-patterns.mdmarkdown5.4 KB
references/kotlin/kotlin-testing.mdmarkdown7.9 KB
references/mcp-local-docs.mdmarkdown6.9 KB
references/mcp-local-docs/mcp-patterns.mdmarkdown9.6 KB
references/mcp-local-docs/mcp-preferred-patterns.mdmarkdown6.9 KB
references/mcp-local-docs/server-templates.mdmarkdown4.4 KB
references/mcp-local-docs/typescript-async-patterns.mdmarkdown8.9 KB
references/nodejs-api.mdmarkdown7.3 KB
references/nodejs-api/auth-patterns.mdmarkdown10.0 KB
references/nodejs-api/middleware-patterns.mdmarkdown10.5 KB
references/nodejs-api/nodejs-security.mdmarkdown12.3 KB
references/nodejs-api/webhook-patterns.mdmarkdown9.9 KB
references/php-general.mdmarkdown4.7 KB
references/php-general/php-behaviors.mdmarkdown5.2 KB
references/php-general/php-conventions.mdmarkdown5.8 KB
references/php/modern-php-features.mdmarkdown4.4 KB
references/php/testing-patterns.mdmarkdown7.5 KB
references/python-general.mdmarkdown7.7 KB
references/python-general/flask-jinja-webapp.mdmarkdown5.7 KB
references/python-general/python-local-gates.mdmarkdown4.4 KB
references/python-general/python-modern-code.mdmarkdown23.1 KB
references/python-openstack.mdmarkdown5.2 KB
references/python-openstack/error-handling.mdmarkdown658 B
references/python-openstack/hacking-rules.mdmarkdown4.1 KB
references/python-openstack/openstack-patterns.mdmarkdown1.2 KB
references/python-openstack/oslo-patterns.mdmarkdown6.4 KB
references/python-openstack/output-format.mdmarkdown2.4 KB
references/python-openstack/preferred-patterns.mdmarkdown1.9 KB
references/python-openstack/rpc-versioning.mdmarkdown5.3 KB
references/rust-general.mdmarkdown8.2 KB
references/rust-general/rust-modern-code.mdmarkdown13.4 KB
references/rust-general/rust-verification-workflow.mdmarkdown5.5 KB
references/rust-general/rust-version-idioms.mdmarkdown7.0 KB
references/swift-general.mdmarkdown5.7 KB
references/swift-general/swift-patterns.mdmarkdown6.7 KB
references/swift-general/swift-security-testing.mdmarkdown6.6 KB
references/swift-general/swift-security.mdmarkdown13.3 KB
references/swift/preferred-patterns.mdmarkdown2.4 KB
references/swift/swift-testing.mdmarkdown6.6 KB
references/swift/task-patterns.mdmarkdown3.6 KB
references/typescript-debugging.mdmarkdown9.3 KB
references/typescript-debugging/debugging-workflows-async-memory.mdmarkdown5.8 KB
references/typescript-debugging/debugging-workflows.mdmarkdown5.6 KB
scripts/bench-compare.shscript7.1 KB
scripts/check-errors.shscript7.1 KB
scripts/check-interface-compliance.shscript6.4 KB
scripts/check-sapcc-auth-ordering.shscript5.5 KB
scripts/check-sapcc-httptest.shscript4.4 KB
scripts/check-sapcc-identify-endpoint.shscript5.8 KB
scripts/check-sapcc-json-strict.shscript4.9 KB
scripts/check-sapcc-time-now.shscript4.2 KB
scripts/check-sapcc-todo-format.shscript4.1 KB
scripts/gen-table-test.shscript4.2 KB
scripts/quality_checker.pyscript16.2 KB
scripts/sync-google-style-guide.pyscript2.5 KB
scripts/validate.pyscript6.3 KB

references/go/sapcc-conventions/extended-patterns.md

View on GitHub
# Extended Patterns from SAP CC Personal Repos

Patterns extracted by the `github-profile-rules` pipeline (2026-03-11) from 20 public repos including portunus, alltag, gg, prometheus-minimum-viable-sd, and rust-jmdict, plus helm-charts and limes PR reviews. **These extend the keppel-derived patterns -- they do not replace them.**

Context difference: keppel uses go-makefile-maker which auto-generates CI, REUSE config, and licensing tooling. Personal repos configure these manually, which surfaces explicit preferences not visible in keppel.

---

## 1. Security Micro-Patterns

From portunus and alltag -- security-conscious patterns that appear consistently across personal work.

### Timing Side-Channel Avoidance

When a user lookup fails (e.g., username not found), perform the expensive operation anyway (bogus bind, dummy hash check) before returning. This prevents attackers from inferring whether a username exists from response timing.

```go
// BAD: returns immediately on user-not-found -> timing leak
if user == nil {
    return ErrInvalidCredentials
}
ldapConn.Bind(user.DN, password)

// GOOD: perform bind even for non-existent users (alltag/internal/auth/ldap.go)
// Comment: "attempt to bind anyway... This avoids a timing side-channel, where
// an attacker could infer whether a user exists based on response time"
if user != nil {
    ldapConn.Bind(user.DN, password)
} else {
    ldapConn.Bind("nonexistent", password) // bogus bind to equalize timing
}
```

### crypto/rand Only -- Never math/rand

Use `crypto/rand.Reader` for all security-sensitive randomness. Panic on failure -- a failure to generate randomness is a fundamental programming error, not a recoverable runtime error.

```go
// From portunus/internal/core/random.go
func GenerateRandomKey(length uint) []byte {
    buf := make([]byte, length)
    _, err := io.ReadFull(rand.Reader, buf) // crypto/rand
    if err != nil {
        panic(err.Error()) // "AS IT FUCKING SHOULD"
    }
    return buf
}
```

### Input Validation Against Injection

Validate input character sets for fields used in query construction (LDAP filters, SQL identifiers). Reject ASCII symbols in usernames to prevent LDAP injection. This is explicit input rejection, not sanitization.

```go
// from alltag: reject ASCII symbols in usernames to prevent LDAP injection
// character set allowlist is narrow by design
```

---

## 2. Visual Section Separators

Lines of forward slashes are used as horizontal rules to divide major logical sections within a file. This appears consistently across Go, JavaScript, and Rust files.

```go
////////////////////////////////////////////////////////////////////////////////

// This is a new logical section -- e.g., "announce" vs "collect" functions,
// or "helpers for templates" vs "general page layout"

func nextSection() {
```

Use these when a file has 2+ logically distinct groups of functions that would be clearer separated visually. Reserve section markers for major logical groups (2+ distinct concerns), not individual function boundaries.

---

## 3. Copyright Header Format

Two formats depending on project era:

**Older projects** -- boxed comment block:
```
/******************************************************************************
* Copyright 2019 SAP SE                                                       *
* SPDX-License-Identifier: GPL-3.0-only                                      *
* Refer to the file LICENSE for details.                                      *
******************************************************************************/
```

**Newer projects** -- SPDX short form (preferred now):
```go
// SPDX-FileCopyrightText: 2025 SAP SE
// SPDX-License-Identifier: Apache-2.0
```

For keppel: go-makefile-maker handles REUSE/SPDX configuration automatically via `REUSE.toml`. Do not configure manually.

---

## 4. Kubernetes Namespace Isolation

From helm-charts PR reviews -- each service must run in its own Kubernetes namespace.

**Rule**: Never add a new service to a shared namespace (monsoon3, monsoon3global) unless it requires **direct volume access** to another service's data. API communication is not a sufficient reason to co-locate.

> "I want to hear a compelling reason why prodel absolutely has to live in the same namespace as Keystone... The only compelling reason I can think of is direct volume access." -- helm-charts review

> "we really need to kick this habit of stuffing everything into the same namespace... we will have hard requirements to pull everything out" -- helm-charts review

---

## 5. Code Hygiene in PRs

These rules appear repeatedly in PR reviews -- apply to every PR, not just the specific file being changed.

### Clean Up Orphaned Declarations

When a change removes a reference (e.g., a template variable, an import, an env var reference), remove its **declaration** too. Apply this to ALL files the PR touches, not just the one where the reference was removed.

> "Since the reference to $registry is removed, its declaration should be cleaned up. This also applies to other files where similar changes are made." -- helm-charts review

### Sort Configuration Lists

Keep allowlists, configuration lists, and similar ordered collections sorted alphabetically. Reason: cleaner diffs and easier to spot duplicates.

> "Please sort." -- helm-charts review

### Document New Config Fields in the Same PR

When adding new configuration fields or API parameters, document them in the project's `docs/` directory in the same PR. Do not add features without updating their documentation.

> "Please document newly added config fields in docs/liquids/" -- limes review

---

## 6. Changelog Format (Personal Repos)

Personal repos maintain `CHANGELOG.md` at repo root with this specific format:

```markdown
# v1.5.0 (2025-11-26)

Changes:
- Add package is.
- Extend package option to add Unwrap().

# v1.4.0 (2025-08-07)

Bugfixes:
- Fix X in case of Y.
```

Headings use `# vX.Y.Z (YYYY-MM-DD)`. Sections use `Changes:` or `Bugfixes:`, not `### Added` / `### Fixed`. One-line bullet points only.

Note: keppel changelog conventions may differ -- check keppel's existing CHANGELOG.md if applicable.

---

## 7. Test Flags (Personal Repos / Non-go-makefile-maker Projects)

Personal CI runs Go tests with two additional flags:

```yaml
# from gg/.github/workflows/checks.yaml
go test -shuffle=on -coverprofile=build/cover.out -covermode=count ./...
```

- **`-shuffle=on`**: Randomizes test execution order to detect order-dependent tests. Any test that passes in default order but fails shuffled has an implicit dependency on prior tests.
- **`-coverprofile`**: Generates coverage reports for upload to external services.

For keppel: go-makefile-maker controls test flags via `Makefile.maker.yaml`. Use `coverageTest.*` configuration instead of adding flags manually.

---

## Source

Generated by `github-profile-rules` pipeline from 20 repos + 99 PR reviews (2026-03-11).
Confidence-scored: rules in sections 1-4 are high-confidence (seen in 3+ repos or 4+ review comments).
Sections 5-7 are medium-confidence (2 repos or 2-3 review comments).

This file is a complement to `review-standards.md` and the code patterns reference, not a replacement.
rea-changelog-updatemorluto/reaPrepare or rewrite REA release changelogs and GitHub release notes from pinned Git history, with verified contributor thanks and Release Please synchronization.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
academy-guideanthropics/skillsStop and check this skill before finishing any reply to a question about how to use Claude or a Claude product — it recommends matching courses, tutorials, and use cases from Claude Academy (academy.claude.com), Anthropic's learning hub. Trigger on: "how do I", "how can I", "getting started with", "what can Claude do", "teach me", "learn to use"; questions about artifacts, projects, skills, plugins, connectors, MCP; requests about rolling Claude out to a team, class, or organization; and any ask for training materials, onboarding content, or learning resources. Use it when the user is learning how to use a feature or product — not when they are mid-task and just want the task done. This skill composes with other skills: after consulting product documentation to answer how a Claude feature works, also check here for a matching course or tutorial — a docs-grounded answer and an Academy recommendation belong together. Only recommend on a strong match; never invent Academy content.Stars: 197kUpdated Claude CodeCodexVerifiedInstall
claude-apianthropics/skillsReference for the Claude API / Anthropic SDK — model ids, pricing, params, streaming, tool use, MCP, agents, caching, token counting, model migration. TRIGGER — read BEFORE opening the target file; don't skip because it "looks like a one-liner" — whenever: the prompt names Claude/Anthropic in any form (Claude, Anthropic, Fable, Opus, Sonnet, Haiku, `anthropic`, `@anthropic-ai`, `claude-*`, `us.anthropic.*`, `[1m]`); the user asks about an LLM (pricing/model choice/limits/caching) — never answer from memory; OR the task is LLM-shaped with provider unstated (agent/MCP/tool-definition/multi-agent/RAG/LLM-judge/computer-use; generate/summarize/extract/classify/rewrite/converse over NL; debugging refusals/cutoffs/streaming/tool-calls/tokens). SKIP only when another provider is being worked on (overrides all triggers): OpenAI/GPT/Gemini/Llama/Mistral/Cohere/Ollama named in the query; OR `grep -rE 'openai|langchain_openai|google.generativeai|genai|mistralai|cohere|ollama'` over the project hits (run this grep FIRST if no provider named — don't Read the file).Stars: 197kUpdated Claude CodeCodexUnverifiedInstall
doc-coauthoringanthropics/skillsGuide users through a structured workflow for co-authoring documentation. Use when user wants to write documentation, proposals, technical specs, decision docs, or similar structured content. This workflow helps users efficiently transfer context, refine content through iteration, and verify the doc works for readers. Trigger when user mentions writing docs, creating proposals, drafting specs, or similar documentation tasks.Stars: 197kUpdated Claude CodeCodexVerifiedInstall