Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
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
5 changes: 5 additions & 0 deletions .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -36,6 +36,11 @@ apm_modules/
# Kind swap tracking
.kind-swaps

# Security audit / threat-model working artifacts
security-audit/
.threat-model-state/
.skillspector-reports/

# Local tool binaries (built by make kind-prereqs)
bin/

Expand Down
111 changes: 111 additions & 0 deletions .skillspector-baseline.yaml
Comment thread
kdoberst marked this conversation as resolved.
Original file line number Diff line number Diff line change
@@ -0,0 +1,111 @@
# SkillSpector baseline - suppress findings outside skill directories
# and false positives within skill directories.
version: 2
rules:
# --- Directory exclusions (not agent skills) ---
- path: "apm_modules/*"
reason: "Upstream dependencies - audited separately by package maintainers"
- path: "components/*"
reason: "Application source code - not agent skills"
- path: "deploy/*"
reason: "Deployment manifests - not agent skills"
- path: "scripts/kind/*"
reason: "Kind dev-cluster scripts - not agent skills"
- path: "scripts/cli-generator/*"
reason: "CLI code generator - not agent skills"
- path: "scripts/sdk-generator/*"
reason: "SDK code generator - not agent skills"
- path: "scripts/openapi-ir/*"
reason: "OpenAPI IR tooling - not agent skills"
- path: "scripts/check_*.py"
reason: "Repository policy check scripts - not agent skills"
- path: "scripts/test_check_*.py"
reason: "Policy check tests - not agent skills"
- path: "scripts/bootstrap_pnpm.sh"
reason: "Bootstrap script - not agent skills"
- path: "scripts/README.md"
reason: "Scripts documentation - not an agent skill"
- path: "tests/*"
reason: "Test code - not agent skills"
- path: ".github/*"
reason: "CI workflow definitions - not agent skills"
- path: "specs/*"
reason: "Specification documents - not agent skills"
- path: "security-audit/*"
reason: "Security audit artifacts - not agent skills"
- path: ".threat-model-state/*"
reason: "Threat model working state - not agent skills"
- path: "DEVELOPMENT.md"
reason: "Project documentation - not an agent skill"
- path: "LICENSE"
reason: "License file - not an agent skill"
- path: "Makefile"
reason: "Build file - not an agent skill"
- path: "apm.lock.yaml"
reason: "Lockfile - not an agent skill"
- path: ".skillspector-reports/*"
reason: "Local SkillSpector scan output - not source code"

# --- False positives in skill/command scripts ---

# AST4: All subprocess calls use shell=False with explicit arg lists
# calling gh/git CLIs - the safe pattern the rule recommends.
- id: "AST4"
path: "*pr-hygiene/scripts/*"
reason: "subprocess.run with shell=False and hardcoded gh/git arg lists - no user-controlled input"
- id: "AST4"
path: "*pr-review/scripts/*"
reason: "subprocess.run with shell=False and hardcoded gh/git arg lists - no user-controlled input"

# AS3: Standard APM @claude/skills/ cross-references, not skill enumeration.
- id: "AS3"
path: "*commands/finish-work.md"
reason: "Standard APM skill reference syntax (@claude/skills/...), not enumeration"
- id: "AS3"
path: "*commands/start-work.md"
reason: "Standard APM skill reference syntax (@claude/skills/...), not enumeration"
- id: "AS3"
path: "*scored-code-review/SKILL.md"
reason: "Deprecation stub referencing replacement skill path, not enumeration"

# E2: Reads GH_TOKEN/GH_TOKEN_<org> for gh CLI auth - never logs values.
- id: "E2"
path: "*pr-hygiene/scripts/pr-hygiene.py"
reason: "Standard GitHub CLI token resolution for multi-org scanning - values never logged"

# EA2: Guide-only skill (presents commands, user executes) and Jira
# issue creation (the skill's purpose, with user confirmation).
- id: "EA2"
path: "*acm-release/SKILL.md"
reason: "Guide-only skill - presents commands for user to run, never executes them"
- id: "EA2"
path: "*jira-log/SKILL.md"
reason: "Creating Jira issues is the skill's purpose - user confirmation built into workflow"

# MP3: Coverage table documenting local-dev capabilities, not memory manipulation.
- id: "MP3"
path: "skills/RECONCILE.md"
reason: "Spec coverage table documenting dev-cluster features - no memory manipulation"

# PE3: Gap table mentioning kubeconfig as future architecture need, not credential access.
- id: "PE3"
path: "skills/RECONCILE.md"
reason: "Architecture gap table referencing kubeconfig as future work - no credential access"

# RA2: Writing a TUI keybinding config file - standard editor setup.
- id: "RA2"
path: "*opencode-setup/SKILL.md"
reason: "Writes tui.json keybinding config - standard editor setup, not session persistence"

# TM3: --tls-verify=false for OpenShift internal registry with self-signed certs
# on dev clusters - documented standard practice.
- id: "TM3"
path: "*deploy-cluster/SKILL.md"
reason: "OpenShift internal registry uses self-signed certs on dev clusters - documented practice"

# P1: Documentation describing kernel-level BPF capability, not an instruction override.
- id: "P1"
path: "*linux-capabilities/SKILL.md"
reason: "Reference documentation describing Linux capability behavior - not an agent instruction override"

fingerprints: []
7 changes: 6 additions & 1 deletion CLAUDE.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,7 @@ checks manually with `make check`.
- `components/control-plane/` - Go service, watches API server via gRPC and reconciles gateway resources into K8s
- `packages/gateway-management-ui/` - Private reusable React package containing canonical gateway management workflows
- `specs/` - Desired state of the system ([platform](specs/platform/), [standards](specs/standards/))
- `skills/` - Agent skills: [reconcile](skills/build/reconcile), [spec](skills/plan/spec), [full-stack-pipeline](skills/build/full-stack-pipeline), [dev-cluster](skills/build/dev-cluster), [ibm-cluster](skills/deploy/ibm-cluster), [deploy-cluster](skills/deploy/deploy-cluster), [cloud-hub-ingress-bootstrap](skills/deploy/cloud-hub-ingress-bootstrap), [review](skills/review/review-guidance), [amber-review](skills/review/amber-review), [ui-standards](skills/review/ui-standards), [tooling](skills/tooling/)
- `skills/` - Agent skills: [reconcile](skills/build/reconcile), [spec](skills/plan/spec), [full-stack-pipeline](skills/build/full-stack-pipeline), [dev-cluster](skills/build/dev-cluster), [ibm-cluster](skills/deploy/ibm-cluster), [deploy-cluster](skills/deploy/deploy-cluster), [cloud-hub-ingress-bootstrap](skills/deploy/cloud-hub-ingress-bootstrap), [review](skills/review/review-guidance), [amber-review](skills/review/amber-review), [ui-standards](skills/review/ui-standards), [tooling](skills/tooling/), [security-audit](skills/security/run-security-audit)
- `apm.yml` - APM manifest declaring upstream skill dependencies

## Key Files
Expand Down Expand Up @@ -76,6 +76,7 @@ Support skills available at any point:
- `/align` -- convention health check
- `/maintain-ci` -- CI workflow and component registration maintenance
- `/update-openshell` -- sync HyperShell to a new upstream OpenShell release (self-reinforcing)
- `/run-security-audit` -- comprehensive security audit (threat model + code audit)
- `/memory` -- project memory management

## Commands
Expand Down Expand Up @@ -103,6 +104,10 @@ make kind-up # Start local Kind cluster
make kind-down # Destroy Kind cluster
make kind-status # Show cluster status
make lint # Lint all Go code

# APM & Security
make apm-install # Install APM dependencies + run security scan
make apm-audit # Run APM security audit
```

## Critical Conventions
Expand Down
20 changes: 20 additions & 0 deletions Makefile
Original file line number Diff line number Diff line change
Expand Up @@ -133,6 +133,11 @@ help:
@echo " hooks-install Install Git hooks (lefthook)"
@echo " hooks-run Run hook checks manually"
@echo ""
@echo " APM"
@echo " apm-install Install APM dependencies + run security scan"
@echo " apm-install-force Install APM dependencies + require skillspector scan (CI)"
@echo " apm-audit Run APM security audit"
@echo ""

# ============================================================================
# Build targets
Expand Down Expand Up @@ -219,6 +224,21 @@ hooks-install:
hooks-run:
$(LEFTHOOK_CMD) run check

# ============================================================================
# APM
# ============================================================================

.PHONY: apm-install apm-install-force
apm-install:
@scripts/apm-install.sh

apm-install-force:
@scripts/apm-install.sh --force

.PHONY: apm-audit
apm-audit:
apm run audit

# ============================================================================
# Lint targets
# ============================================================================
Expand Down
Loading
Loading