Skip to content

docs: Address Harness AI documentation gaps for MQ DevSecOps Platforms 2026#11832

Open
thisrohangupta wants to merge 2 commits intoharness:mainfrom
thisrohangupta:docs/harness-ai-mq-gaps
Open

docs: Address Harness AI documentation gaps for MQ DevSecOps Platforms 2026#11832
thisrohangupta wants to merge 2 commits intoharness:mainfrom
thisrohangupta:docs/harness-ai-mq-gaps

Conversation

@thisrohangupta
Copy link
Contributor

Summary

  • Undraft PR Summaries page and expand it with comprehensive code review assistance documentation, addressing the MQ "code review facilitation" requirement
  • Add IACM pipeline creation and multi-module pipeline support to DevOps Agent docs, addressing the MQ "Infrastructure as Code" and agentic CI/CD requirements
  • Add API spec generation section to Code Agent docs, documenting OpenAPI/Swagger generation from codebases
  • Expand overview feature table from 12 to 23 entries covering all Harness AI capabilities across modules (DevOps Agent, Code Agent, PR Summaries, IACM, SEI, AI SRE, AI Test, MCP Server, etc.)
  • Add IACM and multi-module example prompts to the Create with AI page
  • Remove "Infrastructure Definition Creation" from the unsupported list since IACM pipelines are now supported

Context

These changes address documentation gaps identified during analysis of the Gartner Magic Quadrant and Critical Capabilities for DevSecOps Platforms, 2026 inclusion criteria. Specifically:

Gap Identified Resolution
Terraform/IaC generation not documented Added IACM pipeline creation docs with example prompts
API spec generation not documented Added API Spec Generation section to Code Agent
PR summaries not publicly visible (draft: true) Undrafted and expanded with code review assistance
Code review assistance not framed as GenAI capability New dedicated section in PR Summaries page
Overview table incomplete Expanded to 23 entries covering all AI capabilities

Files Changed

  • docs/platform/harness-aida/aida-code-pr.md — Undrafted, rewritten with PR summaries + code review
  • docs/platform/harness-aida/aida-overview.md — Expanded feature table
  • docs/platform/harness-aida/ai-devops.md — Added IACM + multi-module pipeline support
  • docs/platform/harness-aida/code-agent.md — Added API spec generation
  • docs/platform/harness-aida/harness-create-with-ai.md — Added IACM/multi-module prompts, updated unsupported list

Test plan

  • Verify all internal doc links resolve correctly (anchors and page paths)
  • Confirm aida-code-pr.md renders as a published page (no longer draft)
  • Review overview table formatting in rendered markdown
  • Validate IACM pipeline example prompts work with the DevOps Agent

🤖 Generated with Claude Code

…s 2026

Close documentation gaps identified during MQ inclusion criteria analysis:
- Undraft and expand PR Summaries page with code review assistance docs
- Add IACM pipeline creation and multi-module pipeline support to DevOps Agent
- Add API spec generation capability to Code Agent docs
- Expand overview feature table from 12 to 23 entries covering all AI capabilities
- Add IACM and multi-module example prompts to Create with AI page
- Remove outdated "Infrastructure Definition Creation" from unsupported list

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Semantic Code Search and AI Scribe Agent pages are not available in the
build (draft or excluded), so remove the hyperlinks while keeping the
feature descriptions in the overview table.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@bot-gitexp-user
Copy link

Please check the Execution Link of the Pipeline for the Website Draft URL. This is located in the Preview Step behind the Harness VPN and also is available in #hdh_alerts. E.g Website Draft URL: https://unique-id--harness-developer.netlify.app. Current Draft URL is: https://698112ef563c0c0523c2778f--harness-developer.netlify.app

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.

2 participants