AI SummaryCopilot instructions for the OSAFW ASP.NET Core business application framework that guides developers through a structured task workflow with documentation, decision tracking, and post-processing optimization. Developers working with OSAFW on C# and ASP.NET Core projects benefit from standardized task management and knowledge capture.
Install
Copy this and paste it into Claude Code, Cursor, or any AI assistant:
I want to add the "osafw-asp.net-core — Copilot Instructions" prompt rules to my project. Repository: https://github.com/osalabs/osafw-asp.net-core Please read the repo to find the rules/prompt file, then: 1. Download it to the correct location (.cursorrules, .windsurfrules, .github/prompts/, or project root — based on the file type) 2. If there's an existing rules file, merge the new rules in rather than overwriting 3. Confirm what was added
Description
Business Application Web Framework. C#, ASP.NET Core
Project Overview
• osafw-asp.net-core is an opinionated ASP.NET Core (.NET 8) web framework/template for building data-heavy admin and CRUD apps. • Core concepts: • FW request pipeline with custom router and RESTful mapping. • ParsePage template engine for views (no Razor). Templates live in App_Data/template. • MVC-ish structure: controllers, models, templates; models use thin DB helper. • Dynamic and Vue controllers driven by JSON config to scaffold CRUD quickly. • Built-in features: logging, caching, file uploads, settings, activity logs, self-test, virtual controllers, scheduled tasks. • Runtime: • Program.cs uses minimal hosting, config via FwConfig, sessions via distributed SQL cache (fwsessions), data protection keys in fwkeys. • Optional MySQL support via #define isMySQL and matching SQL scripts. • Database: • SQL Server by default; schema scripts under App_Data/sql. Key tables: users, settings, spages, att, activity_logs, fw (framework).
Process/Workflow for each user query
• Create task summary file docs/agents/tasks/summary-<YYYY-MM-DD>-<TASK-ID>.md per template in <task-summary-template>
Heuristics (keep terse)
</task-summary-template> • Work on user's query/task, update task summary file as needed • Post-process - after user's query is completely resolved, perform self-reflection, self-improvement, and optimization of the entire process/workflow, see steps in <post-process> <post-process> • review task summary file, make sure it's complete • classify discoveries: • STABLE FACT - add to domain.md or glossary.md or AGENTS.md relevant section • HEURISTIC - add to heuristics.md, timestamp new heuristics and expire or revise anything older than 90 days. • ONE-OFF - keep in task summary file only • if a substantial business decision changed, add an ADR under docs/agents/adr/. • keep all knowledge concise and informative • replace "YYYY-MM-DD" with today's date. • don't store secrets or large logs. </post-process> Whenever AGENTS.md updated - make copy of it to top level /.github/copilot-instructions.md
Folder Structure
• osafw-app/Program.cs - app entrypoint and middleware registration. • osafw-app/App_Code/fw/ - core framework: • FW, FwController, FwAdminController, FwVueController, FwDynamicController, FwVirtualController • DB, FwConfig, FwCache, FwLogger, FwExceptions, FwReports, FwCron(Service), FwUpdates • helpers: Utils, FormUtils, DateUtils, ImageUtils, UploadUtils, SiteUtils, ConvUtils • templating: ParsePage (+ options in FW.parsePageInstance) • osafw-app/App_Code/controllers/ - site controllers (Admin, Dev, My, auth, public). • osafw-app/App_Code/models/ - models per table and domain (Att, Demos, Roles, Reports, Dev*). • osafw-app/App_Data/template/ - templates, common includes, per-controller subfolders, dynamic configs. • osafw-app/App_Data/sql/ - SQL scripts: fwdatabase.sql, lookups.sql, optional roles.sql, demo.sql, and updates/*. MySQL variants under mysql/. • osafw-app/docs/ - framework docs and ADRs. • osafw-tests/ - tests project.
Discussion
Health Signals
My Fox Den
Community Rating
Sign in to rate this booster
Works With
Any AI assistant that accepts custom rules or system prompts