akasper / akasper/plate

[Epic]: Scheduled autonomous operations: refactor/rearch, deploy, release cut/finalize/implement, marketing + marketplace packaging (v1.0.0)

Open
#641 2 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

area:agent area:infra Epic need:refinement risk:medium status:implemented status:stub
Dominant language
Python
Stars
1
Forks
0
Avg merge
8m
Merged PRs (30d)
3

Description

Stub Epic for v1.0.0 autonomous scheduled + deployment capabilities (under sub-Epic in #654).

The system can autonomously (via .agentic/procedures/ + AutonomyEngine):

  • Perform refactor and rearchitecture tasks on a scheduled frequency (with safety, tests, PRs)
  • Deploy to production (risk + approval gated)
  • Implement an epic (full scope delivery)
  • Cut and finalize a release
  • Implement a release (the changes that constitute it)
  • Deploy a marketing site / docs site
  • Package software and deploy to a marketplace (Copilot CLI, etc.)

Roadmap: #654
Foundation: Epic #470 procedures + schedules, deploy skills, cut_release.py + release ceremony, marketing skills, existing gh-plate / marketplace work (#377 etc).

Detailed end-to-end user stories for release cut/finalize/implement and marketing deploy (added per Q&A)

Story: Autonomous release cut and finalize from feed trigger

  1. Release planning (#629) completes; feed surfaces "Release vX.Y planning approved. Ready for cut? (scope locked, media planned)."
  2. User (or low-risk schedule) approves.
  3. Agent runs cut procedure: collects fragments, renders notes with GIFs (#635), updates changelog, creates release branch if needed, opens draft Release PR or tag prep.
  4. For finalize: runs tests, captures final media, packages, surfaces checkpoint: "vX.Y notes + 3 GIFs ready. Cost: Y tokens. Approve finalize & tag?"
  5. On approve: cuts tag, publishes GitHub Release with media, updates marketplace if applicable (#652), notifies feed.

Story: Implement release changes + marketing site deploy

  1. After cut, system implements the release (cherry-picks or merges approved features).
  2. For marketing: deploys updated site/docs with new release highlights and GIFs (via deploy skill).
  3. Full babysit on any PRs, with checkpoints for high-risk deploys.
  4. Surfaces in feed: "Marketing site updated for vX.Y (live at URL, includes approved GIFs)."

Story: Scheduled refactor as part of release prep
Nightly procedure identifies rearch opportunity (from drift audit). Runs refactor (tests first), opens PR, babysits, merges if low risk or with checkpoint.

Combined 'full release cycle from planning to marketing deploy' story using multiple specialized sub-agents (added per Q&A)

  1. PM/Orchestrator (#660) polls What's Next, sees approved release plan. Delegates to 'Release Engineer' persona sub-agent (cautious, packaging-focused) for cut: gathers fragments, renders notes/GIFs.
  2. Simultaneously or next, delegates to 'Creative Storyteller' designer sub-agent for marketing assets (new GIFs, visuals for site).
  3. Orchestrator coordinates: waits for both, runs simulation/budget check, surfaces unified checkpoint in feed with contributions from both agents: "Release vX.Y ready (Release Engineer: notes + package; Designer: updated marketing GIFs and site draft). Approve cycle?"
  4. On approve, PM assigns implement/deploy to appropriate sub-agents (e.g. 'Pragmatic Hacker' for merges, 'Deployer' for marketing site + marketplace).
  5. Sub-agents execute with PM oversight (hand-offs via narrow context), full babysit where needed, respect budgets.
  6. PM aggregates results, updates feed, posts completion with per-agent usage if tracked.

Scheduled Refactor/Rearch detailed story (with PM orchestration, safety, tests, feed) (added per Q&A)

  1. PM/Orchestrator detects due scheduled refactor procedure (from .agentic/procedures/ or health drift).
  2. Polls What's Next for candidates (e.g. high complexity areas flagged in audits). Assigns to 'Refactorer' persona sub-agent (specialized in cleanups, with safety focus).
  3. Sub-agent runs simulation (#645) first: proposes changes, estimates cost/impact, generates before/after tests.
  4. PM surfaces in feed: "Scheduled rearch candidate: simplify auth module (Refactorer agent). Shadow shows -15% complexity, all tests green, budget ok. Approve execution? (or assign different persona for review)."
  5. On approve (or auto low-risk), sub-agent implements (TDD: failing tests for desired state, then refactor), opens PR, full babysit.
  6. PM monitors budget continuously; if overrun risk, checkpoints or throttles.
  7. On success: merges, updates artifacts, posts to feed with story of what was done. May trigger follow-up Questions or Tasks.

Full Epic Implement story (PM orchestration of whole Epic with multiple personas, feed checkpoints, budget tracking) (added per Q&A)

  1. After epic planning (via #656 surfaces), PM/Orchestrator (#660) creates Epic stub, breaks into child Features/Research/Design, assigns initial budget from .plate or user approval.
  2. PM polls What's Next, sees Epic #E ready. Delegates planning artifacts to sub-agents: 'Planner' persona for feature breakdown, 'Researcher' for any open Questions, 'Designer' variants for visuals.
  3. Coordinates parallel: e.g., one dev persona implements core feature (with simulation), designer creates marketing GIFs, another handles tests/docs.
  4. Throughout: surfaces checkpoints in feed for key milestones (e.g., "Design approved for Epic #E? Budget used 40%. Multiple personas active."), with driver labels visible.
  5. Uses simulation for risky parts, real-time webhook updates to re-prioritize if issues arise.
  6. When children complete, PM orchestrates epic-close: collects media, updates SPEC/AGENTS if needed, prepares release track PR.
  7. Final checkpoint: "Epic #E ready for close (all personas contributed, budget on track, GIFs attached). Approve merge to release?"
  8. On approve, handles ceremony, updates feed with full provenance (which persona did what).

Key: Risk-gated, media integrated, feed visibility, usage reports, procedures in .agentic/.

Detailed stories/metrics for full release ceremony (cut/finalize/implement/deploy via PM) (added per Q&A)

Story: Full autonomous release ceremony orchestrated by PM

  1. PM detects due release (from schedule or health). Polls What's Next for scope from Epics/Features.
  2. Delegates to 'Release Engineer' + 'Creative Storyteller' + 'Deployer' sub-agents:
    • Cut: fragments, notes, GIFs, tag prep.
    • Finalize: tests, media approval checkpoint, publish GitHub Release.
    • Implement: merge to release branch, update marketplace/docs.
    • Deploy: marketing site + prod if gated.
  3. PM surfaces unified feed item with multi-persona contributions: "vX.Y ceremony: notes + 5 GIFs + site update ready. Budget: 8k tokens. Approve full cycle?"
  4. On approve (or low-risk auto): PM coordinates parallel execution with webhooks for real-time updates. Handles any babysit/feedback.
  5. Completion: feed updated with links, per-persona usage, driver labels, SPEC update if needed.

Release ceremony metrics via PM (proposed):

  • Time from planning approval to live (target: <4h for minor, with media).
  • % automated (e.g., 90%+ for cut/publish, checkpoints only for high-risk deploy).
  • Media coverage: 100% of user-facing Features have approved GIFs in notes/site.
  • Budget adherence: < estimated, logged per sub-agent.
  • Success signal: GitHub Release published, marketplace updated, marketing site live, health green, feed has post-release Questions (e.g., feedback monitoring).
PM in other release edges (added per Q&A)

Story: Third-party agent in release ceremony

  1. PM detects need for external packaging tool (third-party registered agent via skills).
  2. Orchestrator delegates packaging step to third-party sub-agent (with narrow context: fragments, media).
  3. PM monitors via webhook, surfaces checkpoint: "Third-party agent X completed marketplace bundle. Verify and approve? (budget +10% for external)."
  4. Human approves; PM integrates output, continues ceremony.

Third-party auth and metrics details (added per Q&A refinement)

  • Auth: PM uses scoped OAuth or token delegation (via .plate or secrets) for third-party; logs auth events with redacted tokens. Revocation via GitHub or PM command.
  • Log format for overrides: "[TIMESTAMP] OVERRIDE driver:human by @user on #E (reason: 'complex deploy'); sub-agents paused: [list]; resume on flip to collaborative."
  • Metrics for third-party contrib %: Tracked in feed completion: "Third-party usage: 15% of ceremony budget (auth: success, latency: 2s); total contrib: 2/5 steps."

Story: Human override during ceremony

  1. During finalize, PM surfaces high-risk deploy checkpoint.
  2. Human sets driver:human on the release Epic via label/field.
  3. PM pauses auto for that part, logs "Human override: manual deploy step".
  4. Human directs or completes, then flips back to collaborative; PM resumes with updated state.

Update this stub with more flows or ACs as Q&A continues.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start with roadmap #654 and foundation epic #470, then inspect .agentic/procedures/, AutonomyEngine, and cut_release.py. The issue describes release, deployment, refactor, marketing, and marketplace flows but does not identify a bounded implementation task. Done would require decomposed child work with risk-gated execution, checkpoints, tests, release publication, and deployment outcomes defined for each flow.

Written by the indexing model from the issue text.

Assessment

Tech stack
python
Domain
ai-infra-agents, devops, release
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Quiet
Clarity
Needs clarification
Newbie friendliness
20/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.