AI Assisted Development Guidance#128
Open
VickM29-bit wants to merge 4 commits into
Open
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Add AI-assisted development and agent guidance
🗣 Description
This PR adds security-minded guidance for AI-assisted software development and
AI agent configuration.
The changes introduce:
ai-assisted-development.mdguide covering responsible use ofAI-assisted development tools such as Cursor, Claude Code, GitHub Copilot,
OpenAI Codex, and similar systems.
ai/directory with guidance for:README.mdso the new guidance is discoverable.The guidance treats AI-generated outputs as untrusted until reviewed, tested,
and validated by a human contributor. It emphasizes conservative use,
protection of sensitive information, least privilege, human approval gates,
reviewable outputs, configuration ownership, and small auditable changes.
💭 Motivation and context
AI-assisted development tools and agents are increasingly used in software
engineering workflows. This PR provides concise, security-minded guidance for
using these tools in a regulated or security-conscious environment without
favoring a specific vendor or relying on hype.
The guidance addresses practical risks including:
sensitive information.
incorrect generated content.
without human approval.
review.
This PR does not establish new legal, procurement, privacy, records management,
accessibility, ATO, or sector-specific policy. Where those concerns apply, the
new guidance directs teams to engage the appropriate authoritative documents
and responsible teams.
🧪 Testing
This is a documentation-only change.
Local validation performed:
Reviewed the new Markdown files for consistency with the repository's
documentation style.
Verified new content follows the repository's Markdown conventions,
including ATX-closed headings and line-length expectations for new content.
Checked edited Markdown files for local lint diagnostics.
Confirmed the new AI guidance is linked from the top-level
README.md.GitHub Actions ran the full pre-commit suite.
Markdown, formatting, shell, Python, Ansible, and other applicable
hooks passed.
pip-auditinitially failed on transitive dependencypyjwt(
PYSEC-2025-183), which is unrelated to this documentation change.✅ Pre-approval checklist
✅ Pre-merge checklist
✅ Post-merge checklist