aws-samples / aws-samples/sample-autonomous-cloud-coding-agents

RFC: Agent-initiated artifact promotion to asset registry

Aperta
#518 0 commenti 0 reazioni 0 assegnatari Vedi su GitHub
governance RFC-proposal
Lingua principale
TypeScript
Stelle
143
Fork
46
Merge medio
3g 10h
PR unite (30g)
24

Descrizione

> **Roadmap:** Central asset registry (#246); Agent asset registry epic
> **Priority:** P3

## Primary area

Cross-cutting / multiple

## Related issue or feature request

Roadmap: Central asset registry, Asset lifecycle management; issue #246 (if filed)

## Summary

Design the lifecycle for **agent-initiated harness artifacts** — tests, temporary tools, reusable skills, verification scripts — created during task execution and optionally **promoted** into the platform asset registry. Literature (arXiv:2605.18747) identifies agent-authored executable artifacts as an underexplored harness layer distinct from system-provided infrastructure.

RFC only; no implementation in this issue.

## Use case and motivation

- Agents that write regression tests or helper scripts today leave them only on the task branch.
- Reuse across tasks requires manual copy or human promotion.
- Registry epic (#246) covers operator-published assets; this RFC covers **agent-origin** assets with stricter governance.

## Proposal

### Artifact classes

| Class | Example | Promotion gate |
|-------|---------|----------------|
| `verification_script` | New pytest module | CI green + human approve |
| `skill` | Claude skill markdown | Descriptor review + Cedar actions audit |
| `mcp_tool_stub` | Local MCP config fragment | Supply-chain review (MCP controls roadmap) |

### Lifecycle states

`ephemeral` (branch-only) → `draft` (registry, task-scoped) → `validated` (CI + review) → `production` (blueprint-pinnable)

### Promotion flow

1. Agent marks artifact in task output manifest (`agent_artifacts[]`).
2. Post-task Lambda or operator CLI `bgagent artifact promote` submits to registry.
3. Cedar policy: who may promote; HITL for production tier.
4. Blueprint pins asset version (no floating `latest`).

### Before / after

**Before:** Useful agent-generated test dies on branch after merge.

**After:** Operator promotes vetted test to registry; future tasks on repo resolve pinned version.

## Out of scope

- Autonomous promotion without human approval
- Unsupervised production deploy of agent artifacts
- Implementation in this RFC issue

## Potential challenges

- **Supply chain:** Agent-generated code in registry is high risk — require signing, scan, quarantine
- **Duplication:** Multiple tasks produce similar skills — dedup/version merge policy
- **Parity:** Registry descriptor must match what agent actually executed (hash match)

## Dependencies and integrations

- Central asset registry epic (roadmap)
- Cedar HITL for promotion approvals
- Tiered validation pipeline for verification scripts
- Capability descriptors roadmap item

## Alternative solutions

- **Git-only promotion:** Merge to repo; no registry — simpler but no cross-repo reuse.
- **Memory-only storage:** Loses executability and versioning semantics.
- **S3 task artifacts only:** No semver or blueprint pinning.

---
**Note:** Non-triaged RFCs may not get timely review. PRs on non-triaged issues might not be accepted.

* RFC PR:
* Approved by:
* Reviewed by:

Guida per i contributori

Apri la guida per i contributori

Direzione di ricerca

Inizia leggendo l’epic del registro centrale degli asset (#246), quindi esamina le classi di artefatti proposte, gli stati del ciclo di vita, il flusso di promozione e le dipendenze elencate in questo RFC. Il lavoro è concluso quando viene prodotto un design revisionato con accordo sui requisiti di governance, validazione, firma, deduplicazione e version-pinning; questa issue non ha esplicitamente alcun ambito di implementazione.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Valutazione

Stack tecnologico
aws
Ambito
cloud, devops, security
Tipo di issue
Funzionalità
Difficoltà
5/5
Tempo stimato
Più di una settimana
Stato di attività
Tranquilla
Chiarezza
Da chiarire
Idoneità per principianti
25/100

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.