Skip to content

feat: add devex doc writer pipeline for autonomous feature proposal generation#1143

Open
notgitika wants to merge 1 commit intoaws:feat/agents-orchestrationfrom
notgitika:feat/devex-doc-writer-pipeline
Open

feat: add devex doc writer pipeline for autonomous feature proposal generation#1143
notgitika wants to merge 1 commit intoaws:feat/agents-orchestrationfrom
notgitika:feat/devex-doc-writer-pipeline

Conversation

@notgitika
Copy link
Copy Markdown
Contributor

Summary

  • Adds an archetype-driven pipeline (agents/devex_doc_writer/) that generates CLI DevEx proposals and implementation plans, grounded in actual codebase patterns via pre-indexed knowledge snapshots
  • Implements ts-morph based knowledge refresh (agents/knowledge/) that extracts primitives, schema shape, deploy flow, and commands from the CLI and CDK repos
  • Two P0 archetypes: new-resource (new service primitive) and scope-widening (expanding existing CLI capabilities like adding Terraform support)
  • Pipeline validates inputs, refreshes snapshots, proposes architecture decisions with reasoning, and assembles writer context for LLM invocation
  • Includes writer prompt (voice/style/tenets), self-reviewer (14-point checklist), templates for both DevEx docs and implementation plans

What's included

Component Purpose
agents/devex_doc_writer/SYSTEM.md Shared engine design (workflow, tenets, metrics, failure modes)
agents/devex_doc_writer/archetypes/ P0 archetype specs (new-resource, scope-widening)
agents/devex_doc_writer/prompts/ Writer persona + self-reviewer quality gate
agents/devex_doc_writer/templates/ DevEx doc + impl plan templates (both archetypes)
agents/devex_doc_writer/main.py Entry point — validates, refreshes knowledge, assembles context
agents/knowledge/refresh.ts ts-morph snapshot generator (10 primitives, 9 schema arrays, 21 commands)
agents/knowledge/extractors/ AST-based extractors for primitives, schema, commands, deploy flow

Test plan

  • python3 main.py --input examples/config-bundle-input.yaml --dry-run validates inputs and checks snapshot
  • python3 main.py --input examples/config-bundle-input.yaml generates 38K char writer context
  • cd agents/knowledge && npm run refresh generates both CLI and CDK snapshots
  • End-to-end: feed writer-context.md into LLM session, verify it produces a grounded DevEx doc
  • Verify generated doc passes self-review checklist

…eneration

Adds an archetype-driven pipeline that generates CLI DevEx proposals and
implementation plans, grounded in actual codebase patterns via pre-indexed
knowledge snapshots.

Components:
- agents/devex_doc_writer/ — pipeline design, prompts, templates, input schema
- agents/knowledge/ — ts-morph based codebase snapshot generator (refresh.ts)

Two P0 archetypes implemented: new-resource and scope-widening.
Pipeline validates inputs, refreshes snapshots, assembles writer context,
and outputs ready-to-invoke prompts for LLM generation.
@github-actions github-actions Bot added agentcore-harness-reviewing AgentCore Harness review in progress and removed agentcore-harness-reviewing AgentCore Harness review in progress labels May 6, 2026
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