SIGNAL CONSCIENCE

The Rational Voice in Your Trading Head.

Filter noise, enforce discipline, and trade with the precision of a machine using AI-powered validation.

---

📖 Introduction

Signal Conscience is not just a trading journal - it is a pre-execution firewall.

In the heat of the markets, emotions run high. FOMO (Fear Of Missing Out), revenge trading, and deviation from strategy are the primary destroyers of capital. Signal Conscience acts as your "System 2" thinking partner. Before you pull the trigger, you submit your trade idea to the Conscience.

Powered by Google Gemini AI, the application analyzes your setup against your defined risk strategies, current market regime, and technical inputs. It doesn't just log the trade; it audits it. If your risk is too high, or your rationale is weak, the Conscience will flag it, effectively saving you from yourself.

---

🚀 Key Features

🧠 AI-Powered Trade Validation

Every trade submission is analyzed by a sophisticated LLM engine.

• Sentiment Analysis: Detecting emotional language in your rationale.
• Confluence Check: Verifying if Technical patterns match the thesis.
• Risk Calculation: Automatic R:R (Risk to Reward) computation.

🛡️ Risk Strategy Guardrails

Define your "Constitution" in the Strategies module.

• Set hard limits for Max Risk per Trade (e.g., 2%).
• Define Max Portfolio Exposure and Max Drawdown.
• The AI validates every new trade against these immutable rules.

📊 Market Regime Detection

Context is king. The system forces you to identify the current environment:

• Trending (Bull/Bear)
• Mean Reverting (Range-bound)
• Volatile / Breakout The AI ensures your strategy matches the regime (e.g., "Don't sell breakouts in a strong bull trend").

💎 Glassmorphic Dashboard

A "stupendous" UI designed for focus.

• Dark Mode Native: Easy on the eyes for late-night sessions.
• Visual History: Badge-based tracking of past decisions (Approved, Caution, Blocked).
• TradingView Integration: Live charts for instant visual validation.

👤 Profile & Analytics

• Track your "Discipline Score".
• Visualize trade distribution.
• Manage subscription and strategy preferences.

---

🛠️ Tech Stack

This project is built with a modern, type-safe, and high-performance stack.

Category	Technology	Description
Framework	Next.js 14	App Router, Server Components, Server Actions
Language	TypeScript	Strict static typing for reliability
Styling	Tailwind CSS	Utility-first CSS with a custom glassmorphism theme
Database	PostgreSQL	Relational data integrity
ORM	Drizzle ORM	Type-safe SQL wrapper
Auth	Clerk	Secure user management and authentication
AI Model	Google Gemini	The intelligence engine behind the analysis
Charts	Recharts	Data visualization

---

⚡ Getting Started

Follow these steps to set up the project locally.

Prerequisites

• Node.js 18+
• PostgreSQL Database
• Clerk Account
• Google AI Studio Key (Gemini)

1. Clone the Repository

git clone https://github.com/yourusername/signal-conscience.git
cd signal-conscience

2. Install Dependencies

npm install
# or
yarn install
# or
pnpm install

3. Environment Setup

Create a .env file in the root directory and populate it with your keys:

# Database
DATABASE_URL="postgresql://user:password@host:port/dbname"

# Authentication (Clerk)
NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY=pk_test_...
CLERK_SECRET_KEY=sk_test_...

# AI
GEMINI_API_KEY=AIzaSy...

# App Config
NEXT_PUBLIC_APP_URL="http://localhost:3000"

4. Database Migration

Push the schema to your database using Drizzle.

npx drizzle-kit push

5. Run the Development Server

npm run dev

Open http://localhost:3000 with your browser.

---

📸 Usage Workflow

1. Define Strategy: Go to the Strategies tab and set your risk parameters (e.g., "Max 1% risk"). Run the AI Audit to optimize it.
2. New Analysis: Click "New Analysis" on the dashboard.
3. Input Data: Enter the Asset (e.g., BINANCE:BTCUSD), timeframe, and your trade thesis.
4. Review: The AI generates a Final Decision Card (Proceed, Caution, or Block) with detailed reasoning.
5. Execute: Only take the trade if the Conscience clears it.

---

🤝 Contributing

Contributions are what make the open-source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

---

Made with 💖 by Vivek