bansos-develop-feature

name	bansos-develop-feature
description	Develop, review, or ship UI and feature changes for wauputr4/bansos / bansos.dev. Use when an AI agent needs to modify the SvelteKit static site, improve mobile UI, add pages/components/data behavior, update SEO, adjust contributor/list flows, prepare PRs, or follow bansos.dev contribution and release expectations.

Bansos Develop Feature

Goal

Ship focused bansos.dev improvements that preserve the static SvelteKit architecture, SEO quality, contributor workflow, and small open-source PR style.

Workflow

1. Identify the smallest files needed for the requested UI or feature change.
2. Follow the existing SvelteKit, component, and data conventions before introducing new abstractions.
3. Keep the site static-friendly for GitHub Pages. Avoid server-only state, databases, secrets in client code, and runtime-only dependencies unless the user explicitly wants an architecture change.
4. Preserve SEO basics for public pages: useful titles, descriptions, canonical/social metadata when the local pattern supports them, and crawlable content.
5. For UI changes, keep desktop clean and make mobile feel native: tight spacing, readable text, stable tap targets, and bottom navigation where the existing design uses it.
6. For data or contributor changes, coordinate with the bansos entry workflow instead of bypassing validation.
7. Run the narrowest useful validation when the user asks for testing or when the change affects shared behavior.
8. Prepare PRs with a clear summary, screenshots or preview notes for UI work, and explicit source/evidence notes for SEO or data behavior.
9. When asked to check reviews or merge, inspect thread-level PR review state and CI status. Fix unresolved, non-outdated actionable comments before merging.

Project Constraints

• Repo: wauputr4/bansos.
• App: static SvelteKit site deployed by GitHub Pages workflow.
• Main data source: src/lib/data/bansos.json.
• Public add flow: npx bansosdev add, issue URL, then automated PR.
• Maintainer direct flow: BANSOSDEV_GITHUB_TOKEN plus --mode direct.
• Good PRs include clear source links, contributor metadata, preview/screenshot for UI, and expected SEO/performance impact when relevant.
• Data PRs should preserve source evidence links and regenerate commit contributor metadata when listings change.

UI Direction

• Respect the current visual language instead of restyling the whole site.
• Prefer reusable components when the same UI appears across home, list, detail, and contribute pages.
• Keep list pages scannable: tag filtering, newest-first defaults, and visible active/expired/upcoming states.
• Avoid hiding important contribution instructions behind interaction-only controls.
• Make long CLI examples readable on mobile without forcing horizontal page overflow.

References

• Read references/bansos-development-rules.md for detailed project conventions, validation commands, PR checklist, and Cloudflare/GitHub release notes.