BUILD LOG
Product Kill Sin Role Founder / PM / Engineer Status Active Development
Focus Systems, AI, UX, Discipline Updated Feb 2026
SYSTEM OVERVIEW
Kill Sin is a mobile discipline app that turns the daily battle against vices into a gamified warfare experience — combining habit tracking, AI mentorship, and ritual systems.
Mission: help users overcome daily struggles through a war-themed, faith-rooted system.
Core idea: every sin is an “opponent,” every day is a battle you log, and Shepard mentors you with scripture + urgency.
MY ROLE
Vision & product strategy (4-feature framework)
AI system design (Shepard training datasets + backend integration)
Full-stack dev (React Native + Expo + Node/Express on Render + AsyncStorage persistence)
Design/theming (neon yellow/black war-room UI, emblems/cutscenes placeholders)
CORE SYSTEMS
Conquer— battle flow
War Log— calendar, records, stats, achievements
Shepard AI— battle mentor + general mode
Check-In System— daily ritual & accountability
Infrastructure— persistence, dev sandbox, iteration tools
Explore System Architecture →
BUILD INDEX
1. Core Navigation & Foundation
2. Conquer System
3. War Log System
4. Shepard AI System
5. Infrastructure & Dev Systems
6. Visual Systems & Progression
7. Check-In System
SECTION 1 — CORE NAVIGATION & FOUNDATION
Purpose: establish the foundation: navigation, feature structure, and theme.
Aug 2025 — Initial Conquer Flow Built
Established the core home screen with four primary modes: Conquer, Comfort, Commandments, and Christ
Implemented early navigation structure and feature separation using a minimal, wireframe-style layout
Built the first Conquer flow, including sin selection across seven categories
Designed a daily battle experience with streak tracking and outcome logging
Integrated AI chat directly into the battle screen to support real-time guidance
Focused on validating core functionality and user flow before visual polish
VERSION 1
Sept 2025 — UI Redesign, Visual Identity
Redesigned the home screen with distinct color-coded cards for each core mode
Introduced clearer visual hierarchy and improved scannability
Moved away from a purely neon yellow/black system toward a multi-color identity
Added grid and holographic-inspired backgrounds to support a futuristic direction
Began shaping the app’s “spiritual warfare” theme through color and layout rather than text alone
VERSION 2
Oct 2025 — Polished Experience
Redesigned the home screen with distinct color-coded cards for each core mode
Introduced clearer visual hierarchy and improved scannability
Moved away from a purely neon yellow/black system toward a multi-color identity
Added grid and holographic-inspired backgrounds to support a futuristic direction
Began shaping the app’s “spiritual warfare” theme through color and layout rather than text alone
VERSION 3
SECTION 2 — CONQUER SYSTEM
The battle dashboard and sin-targeting flow — the core daily 'fight' loop. Users choose a sin, prepare, fight, and reflect.
Aug–Sept 2025 — Initial Conquer Flow Built
Sin Selection screen: Lust, Greed, Gluttony, Laziness, Wrath, Envy, Pride
Per-sin “Today’s Battle” screen with streak tracking + survey prompt + “Talk it out with Jesus AI”
Survey questions capture temptation + difficulty + preparedness, etc.
Chat integration wired to backend + OpenAI; UI includes typing placeholder
Win/Loss tracker hooked into streak count + War Log foundation
VERSION 1
Sept 30, 2025 — Conquer Dashboard + Sin Select Wheel Overhaul
Dashboard layout restructured using absolute positioning
Sin Select Wheel upgraded to a functional 7-node heptagon with colored outlines/connectors
Future-proofed for emblem swaps without breaking layout
SIN SELECT WHEEL UPDATE
DASHBOARD CREATED
Oct 25, 2025 — Conquer Flow Redesign
New dashboard metrics added
Current Streak, Longest Streak, All-Time Conquered/Unconquered, Kill Meter (XP)
“Are You Ready for Battle?” check-in (pre-fight ritual)
Yes → “Go forth and conquer this sin.”
No → “There’s more training to be done, soldier.”
Designed to emphasize preparation/consistency over shame
Sin Dossier Added
Slow the user down just enough to create intentionality
Reframe the sin as an opponent, not an identity
Give context + strategy before engagement
VERSION 2
Oct 26, 2025 — 24-Hour Survey System Polished (full flow restored)
Holographic design stabilized (balanced borders, fixed animations)
Randomized outcome messages for Conquered / Unconquered / No Encounter
Survey flow steps (end-to-end): status selection → tactical debrief → heart reflection → mission prep → “Word from Command”
Future add-ons (you can add later)
“Battle Buttons” final design pass (you noted they’re not final yet)
More battle screens: weapons inventory UI, scripture toolbelt, battle prep modules
Notifications / scheduling: trigger the 24-hour check-in exactly 24h later + reminders
Survey Check In System
SECTION 3 — WAR LOG
Purpose: command center to track battles, history, performance, and progression.
Sept 30, 2025 — War Log Hub Introduced (Major Update)
New War Log hub with 4 tabs: Calendar, Records, Stats, Achievements
Calendar = daily wins/losses visual tracker (placeholder until fully connected)
Records = logs daily battle entries + option to review Shepard conversations
Stats = framework for performance metrics (to be connected)
Achievements organized into war tiers (Basic Training, Active Duty, Elite Commander) + glowing unlock effect
Scrollable achievements layout (harder unlock as you scroll deeper)
VERSION 1
WAR LOG BUTTON
Oct 26, 2025 — Records Tab Completed
Records tab completed so users can revisit every past check-in
Each record shows: sin battled, weapons used, reflection, plan for the next fight
Explicit goal: visible progress + reread your own words + tangible day-by-day growth
Future add-ons
Calendar ↔ streaks ↔ achievements full connection (you called this out as a next step)
Stats pages: month-over-month graphs, streak distributions, relapse triggers, “most dangerous time” insights
RECORDS TAB
SECTION 4 — Shepard AI
Purpose: AI mentor who confronts, guides, and encourages users through battles.
Aug–Sept 2025 — Shepard Backend + Chat UI Integrated
Backend: Node.js + Express deployed on Render; API keys secured as env vars
End-to-end message flow verified: app ↔ backend ↔ OpenAI; chat bubbles + typing indicator experience
Sept 30, 2025 — Shepard Training + Personality Overhaul
Issue: Shepard responses were to vague and surface level.
Shepard training document uploaded/finalized with multi-sin examples
System prompt updated to be: brotherly + scripture-centered + firm/urgent (not soft), with balanced practical steps
First-time intro script created: tap-through mentor dialogue (not skippable)
Cutscene planned later with continue/exit buttons + tap-to-advance + dramatic pauses
Oct 25 2025 — Intel Briefing
Introduced the Intel Briefing concept as a core interaction pattern inside Shepard chats.
Instead of immediately responding conversationally, Shepard now opens many sessions with a structured briefing:
Battlefield Analysis (where and when the sin is most active)
Warning (clear spiritual consequences of delay or compromise)
Tactical Steps (specific, actionable obedience for today, not vague advice)
Scripture Anchor (one verse to frame the battle)
This briefing format was intentionally designed to:
Reframe sin as an external opponent, not the user’s identity
Slow the user down just enough to create intentionality before action
Shift the mindset from emotional venting → spiritual warfare and execution
Rather than feeling like “chatting with an AI,” the Intel Briefing makes each session feel like receiving mission-critical guidance before a decision point.
(Oct 28, 2025 — 2:19 AM) — Dual Shepard Personas: Visual + Behavioral Separation
Implemented a dual-persona Shepard system by fully separating training data, tone, and on-screen behavior into two distinct AI roles.
Two independent training files were created and maintained:
shepard_QA.json
A large, example-dense dataset used to train General Shepard — a conversational Christian AI for questions, reassurance, and faith exploration.
Responses prioritize clarity, explanation, and pastoral tone. Visually, this Shepard appears as a clean, open chat interface with minimal urgency — no warnings, no tactical framing — reinforcing safety and approachability.shepard_Conquer.jsonl
A focused, directive dataset used to train Battle Shepard — a tactical mentor built specifically for conquering sin.
Responses are structured, urgent, and action-oriented. Visually, this Shepard appears inside a mission-styled interface with labeled sections (Intel Briefing, Battlefield Analysis, Warnings, Tactical Steps, Scripture Anchor), reinforcing that the user is entering an active confrontation, not a casual conversation.
Dual Shepard Architecture — Persona-Separated Training Pipelines
SECTION 5 — Infrastructure & Dev Systems
Purpose: fast iteration + safe testing + persistent state that doesn’t wipe progress.
Oct 25, 2025 — DEV/PROD Environment Separation (Major Infra Update)
DEV_SANDBOX flag added in config/flags.js
Dev Mode saves to _DEV AsyncStorage keys; Prod saves to normal keys
Dynamic keys for battles/sins/stats implemented (e.g., @killsin/battles[_DEV])
Automatic production wipe guard added for clean “new-user testing”
Oct 25, 2025 — DevTools Suite + Persistence Fix
Utilities: wipeDevSandbox, wipeProdData, wipeAllKillSinData, hardResetSandbox/Production
Visible “RESET SANDBOX” dev-only button on home screen
Persistence fix: hydrated flag prevents streak/XP resets; resetStateToDefaults centralized
Per-sin + global stat tracking added (totalConquered, totalUnconquered, current/longest streak, killXP, level)
DEV / PROD Sandbox Toggle
SECTION 6 — Visual Systems and Progression
Purpose: make growth visible and motivating through ranks + emblems
(Oct 26, 2025 — 9:17 PM) — Ranking Emblem System Progress
Designed a rank-based emblem system to make spiritual growth visible, motivating, and durable over time.
Each emblem represents a stage of discipline and consistency, not one-off success. Progression is driven by sustained streaks and repeated victories, reinforcing long-term obedience rather than short bursts of effort.
A 10-tier ladder was defined, with each rank symbolizing a deeper level of responsibility and self-mastery:
Early ranks (e.g., Recruit, Foot Soldier) reward showing up consistently
Mid ranks (Warrior, Knight, Captain) represent reliability under pressure
Upper ranks (Commander, Conqueror, Legend) reflect habitual victory
Sin Slayer serves as a capstone emblem — a rare, aspirational achievement signaling mastery over a specific sin
Emblems are designed to feel earned, permanent, and identity-shaping, avoiding reset-heavy mechanics that punish failure.
Ranking Emblems
Final Emblem
(Nov 19, 2025 — 1:53 AM) — Created the Check-In System (Major Milestone)
What exists now (core components)
Voice-powered morning & night check-in survey
Personalized Check-In Dashboard
Dynamic survey generation engine
Dedicated Check-In Flow Navigator
First-time onboarding survey
Record/store/review daily discipline data
A. Voice-Powered Check-In Survey (details)
Voice input (app listens), transcription to text, editable responses
Dynamic question sets for morning vs night
Stored with timestamps in context + AsyncStorage
Auto-generated summaries recorded per check-in
Streak tracking updates via morning/night completion
B. Check-In Dashboard (what it contains)
Shepard status panel, streak indicator, morning/night mission, objective of week
Survey editing/customization + consistency meter (14-day visualization)
Yesterday’s summary/logs + “Your WHY” panel
Dynamic insights placeholder (future behavioral AI)
C. Dynamic Survey Builder
Generates questions based on chosen survey style (minimal/balanced/elite)
Optional modules (faith, lust, health, productivity, etc.)
Splits into morning vs night; saved to context; loaded by engine
D. First-Time Onboarding Flow
Welcome screen → Your WHY → style selection → modules → confirmation → transition to dashboard
Dev-mode override forces onboarding each time for testing
E. Navigation Architecture
New CheckInFlowNavigator keeps onboarding isolated, prevents hijacking rest of app, ensures clean transitions
Why it matters
Check-in is the daily discipline ritual; dashboard is the command center
Voice interaction increases immersion/engagement and reduces friction
Your WHY reinforces motivation; surveys users help design increase stickiness
Progress becomes visible data (streaks/meters/summaries/logs)
SECTION 7 — Check-In System
Purpose: the daily discipline ritual (“spine of the app”)—morning/night voice check-ins, dashboards, and insights.
