aws-fde-delivery
GitHubAWS FDE交付技能,规范以构建为核心的交付流程。要求输出代码POC、IaC基础设施即代码、基于真实数据的成本估算及架构评审等五项核心工件,确保方案可执行、成本透明且符合Well-Architected标准,避免仅仅提供概念性建议。
触发场景
安装
npx skills add WingedGuardian/GENesis-AGI --skill aws-fde-delivery -g -y
SKILL.md
Frontmatter
{
"name": "aws-fde-delivery",
"phase": 7,
"consumer": "cc_background_task",
"skill_type": "uplift",
"description": "Forward Deployed Engineer delivery contract for AWS engagements, build-first artifacts, grounded cost estimates, Well-Architected review, evolution roadmap"
}
AWS FDE Delivery
Purpose
Apply a Forward Deployed Engineer (FDE) delivery model to any AWS engagement: show up with a working system, not a slide deck. An FDE embeds with the problem, builds the thing, and proves it runs on real (or realistically simulated) infrastructure before handing off a recommendation. This skill encodes the mandatory artifact set every AWS deliverable must ship with, the rule for grounding cost claims in real pricing data, and the rule for preferring AWS MCP Servers over raw CLI at the execution layer.
This is a delivery contract, not a technical how-to. It governs what "done" means for an AWS engagement deliverable; pair it with the relevant AWS domain skill (serverless, databases, migration, deployment) for the technical implementation itself.
When to Use
- User asks for an AWS solution proposal, architecture recommendation, or POC for a client, prospect, or internal stakeholder.
- A background task is scoped to "build and deliver" something on AWS, not just describe it.
- Career Ops or portfolio work needs an AWS deliverable that has to survive technical scrutiny (interview take-homes, client pitches, demo requests).
- Any output that will be handed to someone else as the basis for a build-vs-buy or architecture decision.
The Build-First Contract
Slideware is not a deliverable. Every AWS engagement ships all five artifacts below, or explicitly marks the ones it couldn't produce and why. Partial delivery is acceptable; silent omission is not.
1. Code / POC
A runnable implementation of the core mechanism, not pseudocode. It doesn't need full production hardening, but it must actually execute against real AWS APIs (or a documented local emulation, e.g. LocalStack) and produce observable output. If the POC is a Lambda, it must invoke. If it's a data pipeline, it must move real (or representative sample) data end to end.
2. IaC (CDK or CloudFormation)
The deployment must be reproducible from code, not a list of console click-steps. Prefer CDK when the audience is engineering-heavy; use raw CloudFormation when the deliverable needs to be inspectable without a build toolchain. Terraform is acceptable only if the client's existing stack already standardizes on it; state that assumption explicitly.
3. Grounded Cost Estimate + Production-Scaling Projection
Two numbers, not one: (a) what this POC costs to run as-is, and (b) what it costs at a stated production scale (e.g. 10x traffic, 100x storage). State the scaling assumption explicitly; never leave "production scale" undefined. See the cost-grounding rule below; this is the section most prone to fabrication and most damaging to credibility when wrong.
4. Well-Architected Review
A short review against the pillars actually relevant to this workload; don't force all six Well-Architected Framework pillars (Operational Excellence, Security, Reliability, Performance Efficiency, Cost Optimization, Sustainability) if only three apply. For each relevant pillar: current-state assessment, specific risk or gap, and a concrete mitigation. Generic pillar summaries with no workload-specific findings don't satisfy this artifact.
5. Evolution Roadmap
A phased path from what was just built to a production system: what changes at each phase, what triggers the move to the next phase (traffic threshold, compliance requirement, team headcount), and what stays deliberately deferred. This is what separates a POC from an orphaned demo.
Cost-Grounding Rule
Cost numbers must trace to one of:
- The AWS Pricing API (preferred; query it directly, don't estimate from memory of list prices, which drift and vary by region).
- Officially documented AWS pricing pages, cited with the specific page and retrieval date.
- The AWS Pricing Calculator, with the exported estimate attached or linked.
If none of these are available for a given cost line (e.g. a preview
service with no published pricing, or a heavily negotiated enterprise
discount you can't see), mark that line UNVERIFIED and state what would
be needed to verify it. Never present a guessed or extrapolated number as
if it were sourced. An UNVERIFIED label is a credible deliverable; a
fabricated number that turns out wrong is not recoverable trust-wise.
AWS MCP Server Execution Layer Rule
When building the POC or IaC, prefer AWS MCP Servers (the awslabs/mcp
family: CDK, Cost Explorer, Pricing, Well-Architected, Terraform, and
service-specific servers) over raw aws CLI invocations wherever an MCP
server covers the needed capability. MCP servers give structured,
schema-validated responses and reduce the chance of a malformed CLI
invocation silently producing wrong output. Fall back to the raw aws
CLI only when no MCP server exists for that capability, and note the
fallback in the deliverable so a reviewer knows where tooling coverage
was thinner.
Deliverable Package Structure
deliverable/
README.md # what this is, how to run it, what it costs
poc/ # runnable code
infra/ # CDK app or CloudFormation templates
COST_ESTIMATE.md # grounded estimate + scaling projection
WELL_ARCHITECTED.md # pillar-by-pillar review
ROADMAP.md # evolution phases
Anti-Patterns
- Shipping only a written proposal with no runnable artifact.
- Presenting a single cost number with no stated scale or source.
- A Well-Architected section that lists all six pillars generically instead of the ones this specific workload actually stresses.
- An IaC template that was never actually deployed to verify it works.
- Reaching for the raw
awsCLI when an MCP server already covers the task.
References
.claude/skills/deliverable-builder/SKILL.md: general send-ready deliverable pipeline; this skill layers AWS-specific artifact requirements on top of it.- AWS Well-Architected Framework: https://aws.amazon.com/architecture/well-architected/
awslabs/mcp: https://github.com/awslabs/mcp
版本历史
- 83a6c7f 当前 2026-07-19 22:29


