Home / PrincipalPath / PrincipalPath Specification
PrincipalPath
Deterministic Interest. Accelerated Payoff.
PrincipalPath is a deterministic mortgage refinancing specification designed for qualifying primary residences. It establishes transparent eligibility requirements, fixed interest calculations, predictable payment obligations, and flexible principal repayment while providing a defined path to accelerated mortgage payoff.
Specification Purpose
PrincipalPath defines a refinancing model in which interest is calculated deterministically using a defined effective interest period and then distributed across a longer repayment schedule. The model is designed to provide a lower scheduled monthly payment while preserving a fixed total interest obligation and allowing borrowers to accelerate payoff through additional principal payments.
The specification prioritizes:
- Deterministic financing calculations
- Transparent qualification requirements
- Primary residence eligibility
- Home equity protection
- Income-based affordability
- Fixed total interest
- Predictable repayment obligations
- Flexible additional principal payments
- No prepayment penalty
- Immediate payoff upon reaching zero principal
- Elimination of unpaid future interest upon payoff
- Auditability and reproducibility
- Human-readable financing results
Core Principles
Deterministic Financing
PrincipalPath must produce the same financing result when identical qualifying inputs are supplied.
The calculation must use defined inputs, formulas, rules, and repayment parameters rather than discretionary or continuously changing interest calculations.
Primary Residence Requirement
PrincipalPath refinancing is limited to qualifying primary residences.
Investment properties, vacation properties, commercial properties, and other non-primary residences are outside the core eligibility scope unless specifically supported through an optional plugin module.
Equity Requirement
The property must have greater than 50% equity at the time of qualification.
Equity = Property Value – Existing Mortgage Balance
Equity Percentage = Equity / Property Value × 100
A mortgage qualifies only when the resulting equity percentage is greater than 50%.
Income Affordability Requirement
The resulting total monthly mortgage payment must not exceed 25% of the gross monthly income of one qualifying homeowner.
Maximum Payment = Gross Monthly Income × 25%
The calculated PrincipalPath monthly payment must be equal to or less than this amount.
Core Modules
Eligibility Module
The Eligibility Module determines whether a mortgage satisfies the fundamental PrincipalPath requirements.
It evaluates:
- Primary residence status
- Property value
- Existing mortgage balance
- Equity percentage
- Gross monthly income of one qualifying homeowner
- Calculated monthly payment
- Affordability threshold
- Required financing inputs
The module must return a transparent qualification result identifying each requirement as satisfied or not satisfied.
Property Valuation Module
The Property Valuation Module establishes the property value used for qualification.
The module must record:
- Property value
- Valuation date
- Valuation source
- Valuation methodology
- Supporting valuation information when available
The property value must be retained as part of the financing record so that the equity calculation can be reproduced.
Equity Module
The Equity Module calculates the borrower’s available home equity.
The module must calculate:
- Property value
- Existing mortgage balance
- Equity amount
- Equity percentage
- Qualification status
The mortgage qualifies under the core specification only when equity exceeds 50% of the property value.
Income Qualification Module
The Income Qualification Module determines whether the resulting PrincipalPath payment satisfies the income requirement.
The module uses the gross monthly income of one qualifying homeowner and calculates the maximum permitted mortgage payment at 25% of that income.
Income qualification must be calculated independently of other household income unless an optional plugin explicitly expands the qualification model.
Deterministic Interest Module
The Deterministic Interest Module calculates the total interest obligation using a defined effective interest period.
The core model uses a 15-year effective interest period.
The module calculates the payment that would be required to amortize the refinanced principal over the defined effective interest period at the applicable interest rate.
The resulting total interest is established as a fixed obligation for the PrincipalPath loan.
Once established, the total interest obligation does not change because of:
- Additional principal payments
- Payment timing
- Declining principal
- Early repayment
- Changes in the remaining scheduled balance
Interest Distribution Module
The Interest Distribution Module distributes the fixed total interest obligation across the repayment schedule.
The core repayment schedule uses a maximum period of 30 years, or 360 monthly payment periods.
The fixed total interest obligation is distributed evenly across the maximum repayment schedule.
Interest does not compound or recalculate during the repayment period under the core deterministic model.
Payment Module
The Payment Module calculates the scheduled monthly payment.
The total repayment obligation consists of:
Original Principal + Fixed Total Interest
The scheduled monthly payment is calculated by distributing the total repayment obligation across the maximum 360 monthly payment periods.
The 30-year schedule represents the maximum repayment horizon and does not require the borrower to remain in the loan for 30 years.
Affordability Module
The Affordability Module compares the calculated PrincipalPath monthly payment with the qualifying homeowner’s gross monthly income.
The payment must not exceed 25% of gross monthly income.
The module must clearly identify:
- Gross monthly income
- Maximum permitted payment
- PrincipalPath monthly payment
- Payment-to-income percentage
- Qualification result
Amortization Module
The Amortization Module maintains the repayment schedule and outstanding principal.
The module must distinguish between:
- Original refinanced principal
- Fixed total interest obligation
- Scheduled principal allocation
- Scheduled interest allocation
- Additional principal payments
- Remaining principal
- Remaining scheduled payment periods
- Payoff status
The module must preserve the deterministic interest obligation independently of changes to principal caused by additional payments.
Additional Principal Module
The Additional Principal Module allows the borrower to make additional principal payments at any time without a prepayment penalty.
Additional payments must:
- Apply directly to outstanding principal
- Reduce the remaining principal balance
- Not reduce the fixed calculated interest obligation through recalculation
- Not trigger a new interest calculation
- Not alter the original deterministic interest calculation
Additional principal payments may allow the borrower to reach full payoff before the maximum 30-year repayment horizon.
Early Payoff Module
The Early Payoff Module establishes the termination rule for the loan.
The fundamental rule is:
Remaining Principal = $0 → Loan Terminated
When the remaining principal reaches zero:
- The loan is immediately considered paid in full.
- All unpaid future interest allocations are eliminated.
- No future interest is owed.
- No future principal is owed.
- No future scheduled payments are owed.
- No residual balance remains.
- No balloon obligation remains.
- No prepayment penalty applies.
The borrower therefore pays only the fixed interest that has been allocated through the actual payment history before full principal payoff, subject to the precise accounting rules defined by the implementation.
Comparison Module
The Comparison Module may compare the PrincipalPath financing result with a conventional mortgage structure.
Comparison results may include:
- Monthly payment
- Total interest
- Total repayment obligation
- Maximum repayment period
- Additional principal flexibility
- Projected payoff timing
- Difference in interest obligation
Comparison results must clearly distinguish deterministic PrincipalPath calculations from conventional amortization calculations.
Scenario Module
The Scenario Module permits borrowers and authorized users to evaluate different financing inputs and repayment strategies.
Scenarios may evaluate:
- Different property values
- Different mortgage balances
- Different interest rates
- Different income levels
- Different additional principal payments
- Different payoff schedules
- Different effective interest periods when supported by configuration
Each scenario must remain independently reproducible.
Refinance Cost Module
The Refinance Cost Module accounts for costs associated with creating the refinanced loan.
Potential costs may include:
- Closing costs
- Origination costs
- Appraisal costs
- Recording costs
- Title costs
- Other permitted refinancing expenses
Refinance costs must be clearly separated from the deterministic interest calculation.
The module must not obscure the distinction between financing costs and interest.
Audit Module
The Audit Module maintains a reproducible record of the financing calculation.
An audit record should contain:
- Property value
- Existing mortgage balance
- Equity amount
- Equity percentage
- Qualifying homeowner income
- Applicable interest rate
- Effective interest period
- Calculated effective-period payment
- Total calculated interest
- Total repayment obligation
- Maximum repayment period
- Scheduled payment
- Additional principal payments
- Remaining principal
- Payoff status
- Relevant calculation dates
- Financing assumptions
- Calculation results
The audit record must allow an authorized reviewer to reproduce the financing result from the recorded inputs and rules.
Transparency Module
The Transparency Module presents financing calculations in a manner that can be understood and independently reviewed.
The system should expose the inputs, formulas, assumptions, qualification results, payment calculations, and payoff rules necessary to understand the resulting financing obligation.
The module must avoid hidden interest adjustments or undisclosed recalculation mechanisms.
Governance Module
The Governance Module defines how the PrincipalPath specification is maintained, interpreted, extended, and modified.
Changes to core financing rules must be explicitly documented.
Optional functionality must not silently alter the deterministic core model.
Extensions that change eligibility, interest calculations, payment calculations, or payoff rules must be identified as extensions rather than represented as core PrincipalPath behavior.
Optional Plugin Modules
PrincipalPath may support optional plugin modules that extend functionality without changing the deterministic core specification.
Appraisal Plugin
Provides integration with property appraisal and valuation services.
Income Verification Plugin
Provides verification of qualifying homeowner income through authorized documentation or external verification services.
Property Tax Plugin
Retrieves and incorporates property tax information for informational affordability analysis.
Insurance Plugin
Provides homeowners insurance information for expanded payment analysis.
HOA Plugin
Provides homeowners association dues and assessments for expanded housing-cost analysis.
Closing Cost Plugin
Provides detailed estimates of refinancing and closing expenses.
Conventional Mortgage Comparison Plugin
Provides expanded comparisons between PrincipalPath and conventional mortgage products.
Rate Scenario Plugin
Allows authorized users to evaluate multiple interest-rate scenarios without changing the core deterministic calculation rules.
Regulatory Compliance Plugin
Provides jurisdiction-specific compliance checks and reporting requirements.
Lender Integration Plugin
Provides integration with participating lenders and authorized lending systems.
Borrower Portal Plugin
Provides a borrower-facing interface for viewing qualification results, financing calculations, payment history, principal payments, and payoff status.
Financial Institution API Plugin
Provides structured interfaces for financial institutions to submit qualifying loan information and retrieve deterministic financing results.
Reporting Plugin
Generates financing reports, qualification reports, amortization reports, audit records, and payoff reports.
Deterministic Repayment Rules
PrincipalPath must preserve the original deterministic interest calculation throughout the life of the loan.
Additional principal payments do not cause the system to recalculate interest using the declining principal balance.
The borrower may accelerate repayment by reducing principal without incurring a prepayment penalty.
The scheduled repayment period is a maximum horizon rather than a required loan duration.
When principal reaches zero, the financing obligation terminates immediately.
Example Calculation
For a qualifying primary residence with:
- Property value: $300,000
- Existing mortgage balance: $140,000
- Gross monthly income: $5,000
- Interest rate: 6%
- Effective interest period: 15 years
- Maximum repayment period: 30 years
The property has $160,000 of equity, representing 53.33% equity.
The 15-year effective amortization calculation produces approximately $72,651.92 of total interest on the $140,000 principal.
The resulting total repayment obligation is approximately $212,651.92.
Distributed across 360 monthly payments, the PrincipalPath scheduled payment is approximately $590.70 per month.
The income-based affordability ceiling is $1,250 per month, representing 25% of $5,000 gross monthly income.
The example therefore satisfies the core equity and affordability requirements.
Specification Branding License (SBL)
Standard
- Fully AGPL-3.0+ compliant system
- Copyleft enforced for network deployments
- Required attribution:
- Roxanne Ardary
- https://www.roxanneardary.com/
Optional
- Specification Branding License (SBL)
- Attribution-free commercial deployment
- Pricing based on scale, usage, and deployment scope
- https://roxanneardary.com/principalpath/
License & Notice Requirements
PrincipalPath is released under the GNU Affero General Public License v3.0 or later (AGPL-3.0+).
By contributing to any Open Arsenal project, you agree that your contributions will also be released under this license.
Please note the following:
- All contributions must comply with the AGPL-3.0+ terms.
- Under Section 7 of the license, all redistributions, forks, and derivative works must preserve attribution to:
Roxanne Ardary and roxanneardary.com. - PrincipalPath specifications are free to use with attribution. A Specification Branding License can be negotiated upon request.
- The project’s notice.md file tracks attribution requirements and contributor acknowledgments. Any update that adds new contributors or modifies attribution should also update
notice.md. - When submitting a pull request, ensure that any new files maintain the attribution headers where applicable.
- Network-deployed versions of this software must also remain fully AGPL-3.0+ compliant, including exposure of source code modifications when applicable under the license.
For full legal details, please refer to the AGPL-3.0+ license and the project’s notice.md file.
Notice – PrincipalPath
Attribution Requirement: Under Section 7 of the AGPL 3.0+ license, all redistributions, forks, and derivative works, including network-deployed versions of this project, must provide attribution to Roxanne Ardary and roxanneardary.com.
Contributors
This file tracks contributors and their specific contributions to the project.
- Roxanne Ardary, roxanneardary.com – September 9, 2026
Created the repository for PrincipalPath. Developed the deterministic mortgage refinancing specification featuring fixed interest, primary residence qualification, equity requirements, affordable payments, additional principal payments, and accelerated payoff. - [Add other contributors here] – [Date]
[Describe contribution in one sentence]
License – PrincipalPath
This repository is licensed under the GNU Affero General Public License v3.0 or later (AGPL-3.0+).
Key Points:
- You are free to use, modify, and distribute the code.
- All redistributions, forks, and derivative works or network-deployed versions must also be licensed under AGPL-3.0+ and provide attribution to Roxanne Ardary and roxanneardary.com as required under Section 7 of the license.
- The software is provided “as is,” without warranty of any kind.
For the full license text, see GNU AGPL-3.0 License.