Skip to content

docs: make skills and instructions action-first - #54

Merged
Zacaria merged 2 commits into
masterfrom
docs/action-first-instructions
Oct 14, 2026
Merged

Zacaria merged 2 commits into
masterfrom
docs/action-first-instructions

Conversation

@Zacaria

@Zacaria Zacaria commented Oct 14, 2026 •

Copy link
Copy Markdown
Collaborator

Summary

  • Rewrite 46 Markdown files: the three skills, README/INSTALL, onboarding, operating guides, references and maintainer instructions, including AGENTS.md.
  • Lead with commands and short numbered steps. Put warnings beside the affected action; remove repeated explanations.
  • Remove 4,614 words (23.3% overall). The investigation skill is about 50% shorter; the Node runtime skill about 54% shorter.
  • Correct stale handoff commands to the actual CLI and README-verification helper. Runtime, tests, package/lock, scripts and plugin manifests are unchanged.

Release Title

  • Conventional Commit title: docs: make skills and instructions action-first

Testing

  • npm run verify: 371 tests across 44 files; types, lint, format, build, packaged-plugin handshake, release contract and packlist passed.
  • npm run docs:build and git diff --check passed.
  • Independent review: all 45/45 diffs PASS; reviewed tree 3e5d62f991300dfe36065066e53e184d11f40c5c. Safety and supported contracts preserved; 50 concrete Bash snippets syntax-checked.
  • Approved follow-up changes only AGENTS.md; the 45 reviewed files are unchanged. Full local verification rerun after this edit. Final tree: 508c57cc2d4c49e2da2adefc24e27fd0e8539804.

Notes

  • Docs updated; no runtime behavior change.
  • No secrets or environment-specific configuration added.
  • The owner requested the protected-file approval again and the AGENTS.md edit succeeded through that flow. The file is now shorter and records the action-first writing rule; existing setup and CLI rules remain intact. No approval blocker remains.
  • No real Kibana, native credential-store, or native client registration checks. No merge, release or deployment performed.

@Zacaria
Zacaria merged commit 6f4ace3 into master Oct 14, 2026
6 checks passed
Zacaria added a commit that referenced this pull request Oct 14, 2026
Ship the installable skill and instruction improvements merged in #54 but skipped by docs-only release analysis. Record product-impact release classification in the checklist and PR template.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant