astro-update-loop
Implement a bounded user-requested change in an approved and shipping-valid Astro site while preserving content coverage, brand system, responsive fidelity, accessibility, performance, and fluid motion. Use as the third loop after content-and-design approval for maintenance, additions, fixes, and refinements.
- License 许可
- MIT
- 最近更新
- 2026-06-23
- Stars
- ★ 0
- Forks
- 0
01 前言 Front Matter
- name
- astro-update-loop
- description
- Implement a bounded user-requested change in an approved and shipping-valid Astro site while preserving content coverage, brand system, responsive fidelity, accessibility, performance, and fluid motion. Use as the third loop after content-and-design approval for maintenance, additions, fixes, and refinements.
02 资源文件 2
- 参考文档agents/openai.yaml293 B
- 参考文档references/change-contract.md396 B
03 SKILL.md 正文
Astro Update Loop
This is loop 3. It is unlocked only after loop 2 is user-approved and npm run shipping:validate
passes. Start a request with npm run update:begin -- <short-request-id>.
Read the change contract. Translate the user's request into a small acceptance checklist before editing. Inspect the affected implementation, existing design tokens, components, tests, and prior adaptation evidence. Do not reopen clone scope or copy removed reference material.
Use astro-builder for application writes. Spawn read-only auditors when the request affects
layout, motion, navigation, multiple routes, or responsive behavior. Give Opus 4.8 literal scope:
name every affected route/state/breakpoint and explicitly name what must remain unchanged.
Prefer existing primitives and tokens. Use Astro components and static HTML first, Alpine for local interaction, GSAP only for evidenced complex timelines/scroll behavior, and Three.js only for an approved 3D requirement. Every new motion must be eased, reversible/interruption-safe where interactive, and reduced-motion compatible.
Run one to three build-audit passes as needed; do not force three passes for a trivial change. Save
evidence under artifacts/update/requests/<request-id>/. Before completion run:
npm run content:validate
npm run content:coverage:validate
npm run artifacts:validate
npm run media:validate
npm run dynamic:validate
npm run shipping:validate
npm run check
npm run build
npm run test:e2e
Write artifacts/update/requests/<request-id>/audit.json with hardGatesPassed, empty p0/p1,
changed files, and verification results. Finish with npm run update:complete. If the request
materially changes brand direction, sitemap, content authority, or approved clone-derived
architecture, stop and ask for explicit scope approval rather than smuggling a redesign into
maintenance.
04 同仓库更多 Skills
web-design-direction
Direct distinctive reference-driven web design, creative elevation, responsive art direction, and fluid motion.
threejs-astro
Implement or audit a performant framework-free Three.js experience in Astro.
tailwindcss-4
Implement and review interfaces with Tailwind CSS 4, reusable tokens, responsive composition, accessible states, and fluid motion.
gsap-fluid-motion
Implement or audit complex, fluid, interruption-safe GSAP motion in Astro.
coding-best-practices
Implement and review reusable, accessible, secure, performant, production-quality web code.
astro-update-loop
Run a bounded post-approval maintenance loop for user-requested changes without regressing the final Astro site's content, design system, responsiveness, accessibility, or motion.