Advise Project Approach

AI agents should not give project advice from vibes.

advise-project-approach is an agent skill for project planning, course correction, and review. Its portable SKILL.md can be loaded by Codex, Claude Code, pi, Hermes, and other Agent Skills-compatible harnesses.

Portability is a design contract, not proof of identical behavior in every host. See the host evidence matrix.

Before recommending a stack, architecture, vendor, refactor, or shipping plan, it checks:

• your actual constraints
• comparable real-world projects
• tradeoffs and failure conditions
• cost and lock-in realities
• when the recommendation becomes wrong

Use It When

• you have a rough project idea and need a build plan
• your repo is getting messy and you need course correction
• you are choosing between stacks or vendors
• you want a review before shipping
• you want the agent to explain what not to build yet

One-Line Install

npx skills@latest add AaravKashyap12/advise-project-approach --skill advise-project-approach

This uses the open skills installer to fetch the repo from GitHub and install only this skill. It requires Node.js/npm. Review installed skills before use; skills run with your agent's normal permissions.

Source of Truth

The runtime skill spec lives in skills/advise-project-approach/SKILL.md. That file is the source of truth for the workflow agents actually run.

Everything else in this repo exists to package, explain, test, or distribute that skill.

What's New in v0.7.2

v0.7.2 addresses concrete failures found by independent audits, adversarial package tests, and repeated model evaluations.

• Adds no-clobber and recovery checks for advice that changes user data, plus stronger concurrency-test guidance.
• Keeps private project details out of public research queries and stops research after an inconclusive follow-up.
• Clarifies project-stage routing, accepted intake unknowns, safety prerequisites, and requested answer limits.
• Hardens YAML/metadata, archive integrity, release consistency, and failed-build handling, with permanent regression tests.
• Preserves failures, mixed baseline comparisons, and post-fix evidence in a dedicated audit report.

See the full changelog for earlier versions.

Where This Fits

Use recent-signal tools to discover what changed.

Use advise-project-approach to decide what to build, change, defer, or avoid.

The skill is not trying to be a general search engine. It is a project-judgment workflow for turning evidence into engineering decisions.

Try These Prompts

"What's the best way to build a self-hosted bookmark manager?"
"Research comparable projects before I start this."
"I'm halfway through building a Node/Express API. Is my approach right?"
"Review my finished project at github.com/owner/repo."
"Should I use Postgres or SQLite for this?"
"What stack should I use given I know Python and want to self-host?"
"Should I use Supabase/Firebase/Neon/Vercel, or will pricing hurt later?"

What It Does

Drop it into your agent and it will: