Skip to content

docs(#70): add skillsaw pip fallback to AGENTS.md - #71

Open
fullsend-ai-coder[bot] wants to merge 1 commit into
mainfrom
agent/70-skillsaw-lint-docs
Open

docs(#70): add skillsaw pip fallback to AGENTS.md#71
fullsend-ai-coder[bot] wants to merge 1 commit into
mainfrom
agent/70-skillsaw-lint-docs

Conversation

@fullsend-ai-coder

Copy link
Copy Markdown
Contributor

Summary

  • Add section 7 "Linting (skillsaw)" to AGENTS.md documenting the pip-based fallback for running skillsaw lint when Docker is unavailable in the agent sandbox
  • Documents pip install skillsaw && skillsaw --strict as the native alternative to make lint
  • Documents skillsaw baseline for updating .skillsaw-baseline.json when pre-existing violations are encountered

Context

On PR #66, the code agent attempted make lint which runs skillsaw in a Docker container. Docker is not available in the agent sandbox, so the agent skipped lint entirely. CI then failed due to a baseline mismatch. A fix agent later discovered the pip approach works natively. This change ensures future agents have the guidance to run skillsaw directly.

Testing

  • Verified skillsaw --strict runs successfully after pip install skillsaw in the sandbox
  • Lint passes with 0 errors (3 deprecation warnings are pre-existing and suppressed by baseline)
  • Secret scan passed on all changed files

Closes #70

Post-script verification

  • Branch is not main/master (agent/70-skillsaw-lint-docs)
  • Secret scan passed (gitleaks — 952caf9bec9a3e23aa2d07aae9488d110c1de27c..HEAD)
  • PR body secret scan passed (gitleaks — no-git)

Document that agents should install and run skillsaw via pip
when Docker is unavailable in the sandbox, rather than skipping
lint entirely. This prevents CI failures from baseline mismatches
going undetected until a human intervenes.

Adds section 7 "Linting (skillsaw)" covering:
- pip install + skillsaw --strict as the native fallback
- skillsaw baseline for updating .skillsaw-baseline.json
- Guidance to not suppress warnings by modifying unrelated lines

Closes #70
@fullsend-ai-review

fullsend-ai-review Bot commented Aug 14, 2026

Copy link
Copy Markdown

🤖 Finished Review · ✅ Success · Started 1:30 AM UTC · Completed 1:43 AM UTC

Commit: bc4e982 · View workflow run →

@fullsend-ai-review

Copy link
Copy Markdown

Review

Findings

Medium

  • [protected-path] AGENTS.md — This PR modifies AGENTS.md, which is a protected governance file (REVIEW_PROTECTED_PATHS). The PR is linked to issue Document skillsaw pip fallback lint command in AGENTS.md #70 and the description clearly explains the rationale: documenting the skillsaw pip fallback so agents can run lint in the sandbox without Docker. The content matches the issue's proposed text verbatim (with only a section number added for consistency). Human approval is always required for changes to protected paths, regardless of authorization context.

Labels: PR adds agent guidance documentation to AGENTS.md

@fullsend-ai-review fullsend-ai-review Bot added requires-manual-review Review requires human judgment documentation Improvements or additions to documentation labels Aug 14, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation requires-manual-review Review requires human judgment

Development

Successfully merging this pull request may close these issues.

Document skillsaw pip fallback lint command in AGENTS.md

0 participants